Skip to main content
This guide walks you through everything you need to do to go from a fresh Altitut installation to publishing your first social post. You will connect your social accounts, wire up the required API keys, run your first Competitor Scout to populate your intelligence library, build a Content Pack, and send a post live — all in a single session.
1

Connect Your Social Accounts

Altitut publishes posts through the Upload-Post service, which acts as the bridge to LinkedIn, Facebook, and Instagram. Before you can post, you need to connect your social accounts inside the Upload-Post dashboard.
  1. Log in to your Upload-Post dashboard.
  2. Create a Profile (for example, my-brand). This name will become your UPLOAD_POST_PROFILE environment variable.
  3. Navigate to Connected Accounts inside that profile and click Add Account.
  4. Authenticate each platform (LinkedIn, Facebook, Instagram) using the OAuth flow provided.
  5. Copy your Upload-Post API key from the dashboard — you will need it in the next step.
Altitut reads the list of connected accounts from Upload-Post at runtime. Any account you connect in the Upload-Post dashboard will automatically appear in the Destinations step of the Auto-Post Composer.
2

Configure API Keys

Altitut requires several API keys to power its AI and data features. Copy the environment template and fill in your values:
Open .env and add the following:
.env
Never commit your .env file to version control or expose these keys on the client side. All API calls that use these credentials are made from the backend — they are never sent to the browser.
After saving the file, start your development server so the new environment variables are picked up:
Open http://localhost:3000 to see the Altitut dashboard.
See the Configuration page for a full breakdown of what each key is used for, Firebase setup instructions, and the optional Telegram bot setup.
3

Run Your First Competitor Scout

With your keys in place, you are ready to build your first intelligence pack. Navigate to the Competitors Analysis tab in the dashboard and click Scout a competitor.The scout runs through several stages automatically:To run the scout:
  1. Enter a description of your product and optionally list any competitors you already know.
  2. Walk through the steps: Discover → Website → Social → Research → Synthesize.
  3. Click Assemble pack then Save.
The pack appears in the dashboard and is immediately available to the AI Copilot for queries.
A full scout with several competitors typically completes in 3 to 6 minutes depending on website complexity. You can monitor real-time stage progress in the dashboard while the pipeline runs.
4

Create Your First Content Pack

Navigate to the Content Creation tab and click on an existing pack, or create a new one. You can also send an Instagram reel URL to your Telegram bot to generate a pack automatically.Each pack is structured into five sections — Overview, Strategy, Series, Recipe, and Execution — giving your team a clear path from idea to published post.
Use the AI Copilot (click Chat on any pack) to ask questions like “What content themes are my competitors using?” before creating a pack. Grounding your strategy in competitor intelligence leads to more differentiated content.
5

Publish Your First Post

Open the Auto-Post Composer by clicking Post on a content pack (or opening the composer from the sidebar). The composer walks you through the following steps:1 — Media: Upload your video or images. Files are uploaded to Firebase Storage and a download URL is passed to Upload-Post at publish time.2 — Destinations: Select the social accounts you want to publish to. All accounts connected in your Upload-Post profile appear here automatically.3 — Copy: Write your caption manually or click Generate captions to produce a platform-tailored caption from your media and content pack context.4 — Review & Publish: Preview your post, then click Publish to send it live.After publishing, the post appears in Post History where you can track its delivery status across all destinations.
You have now completed the full Altitut workflow: intelligence gathering → content creation → publishing. From here, explore the feature pages to go deeper on each capability, or visit the Configuration page to fine-tune your setup.