Skip to main content
Altcraft Docs LogoAltcraft Docs Logo
User guide iconUser guide
Developer guide iconDeveloper guide
Admin guide iconAdmin guide
English
  • Русский
  • English
Login
    Getting StartedAdministrator documentationFunctional characteristics
      Technology descriptionarrow
    • Architecture OverviewComponent Description
        Deployment schemesarrow
      • Basic schemeFail-safe schemeTypical Placement in Infrastructure
    System requirements
      Admin Panelarrow
      • Account areaarrow
        • Accountsarrow
        • Account UsersAccount Virtual SendersAccount Database Indexes
        TariffsExternal data configurationLDAPTasksSchedule JobsGlobal Stop ListsWebversion Store Policies
        Settingsarrow
      • Databases
          Accessarrow
        • AdminsAPI tokens
        Notifiers
          MTAarrow
        • Default rulesRetry rulesLock rulesBounce patternsStrategiesKeysISPsPools
      Nodes
        Sendersarrow
      • EmailSMSEvent generatorIntegration with SendsayENS: настройка сендера
        Reportsarrow
      • Audit JournalData Usage
        Toolsarrow
      • ARF decoderURL decoderSMID decoderLicense
      Platform installationarrow
    • Automatic installationManual installationRunning the platform in a Docker container
      Platform configurationarrow
    • Configuration fileDomain settingsLDAP access configurationSending Email via SMTP relayPixel and push domain configurationCluster and Replication SetupSystem notifications configurationProcesses UNIX sockets configurationHTTPS ConfigurationMigrating from MongoDB Community Edition to Percona Server for MongoDBAdding sender IP addressesDeduplication request settingsPostgreSQL database for account dataProxy server settingsKeycloak Integration with AltcraftGetting HTTP service statusesConfiguration MongoDB logs rotation
        Configuration of system constants and directoriesarrow
      • Filtering bot actionsDirectory of gender markers
      Platform maintenancearrow
    • Personnel requirementsPlatform maintenance processesPlatform updatingPlatform service monitoringBackup and recoveryTransferring the platform to a new serverCreating, deleting, and populating tables for statistics in ClickHouseUsage of the aktool utilityUsers and directories engaged by the platform
      Custom channels guidearrow
    • OverviewCreating and configuring a channelEntity field configurationTemplate languageEntities
        Pipesarrow
      • Pipe: Basic ConceptsResultErrorsLogPackUnpackHTTP RequestStore SetStore GetSelectorSQLEventerScheduler
        Pipelinesarrow
      • Pipeline: Basic ConceptsMessageScheduleListenerModerateStop
      Extraarrow
    • System page customizationSend Message IDИнструкция по миграции истории в ClickHouseInstructions for migrating history to ClickHouseUtility for importing push subscriptions to Firebase projectUtility for importing push subscriptions to Firebase project
    Processing HTTP/HTTPS traffic
      Administrator APIarrow
      • Accounts admin apiarrow
        • Restricted accessarrow
        • Account Activation and DeactivationAccount Freeze and Unfreeze
        Get accounts listAdd a new accountDelete the account
        Account usersarrow
      • Update an Existing AccountAdd a new accountDelete a userGet a list of usersSending a Welcome Email
        Nodesarrow
      • Synchronize node MTA configurationGet nodes listGet node MTA statusActivate node MTADeactivate node MTA
        Senders admin apiarrow
      • Create or update AKMTA senderGet AKMTA sender informationAssign account to senderGet senders listDelete senderRestore sender
          Sender queuearrow
        • Get sender queue informationHold sender queueRelease sender queueClear sender queue
        Virtual sendersarrow
      • Get virtual senders listGet virtual sender informationCreate virtual senderUpdate virtual senderClone virtual senderDelete virtual sender
    Documentation Archive
  • Platform configuration
  • PostgreSQL database for account data

PostgreSQL database for account data

PostgreSQL installation​

You can find PostgreSQL installation instruction for Ubuntu here: https://www.postgresql.org/download/linux/ubuntu/

info

PostgreSQL must be connected to enable the Market module. For correct operation, PostgreSQL version 16.1 or higher is required.

User and database configuration​

caution

A standard variant with local database installation is described. In this example we use altcraft as the username, but you can specify any arbitrary name.

After you have PostgreSQL installed, make the following preparations:

  • Re-login as the newly created user postgres:
su - postgres
  • Run the PostgreSQL command shell:
psql
  • Create a user through which we will connect to PostgreSQL:
CREATE USER altcraft WITH PASSWORD 'myPassword';
  • Check if the user has been created:
\du
  • Give permission to create the database to the user:
ALTER USER altcraft CREATEDB;
  • Create the database:
CREATE DATABASE ak_init_db OWNER altcraft;
  • Grant the user database rights:
GRANT ALL PRIVILEGES ON DATABASE ak_init_db TO altcraft;
  • Add the following lines to the end of the /etc/postgresql/<version_postgresql>/main/pg_hba.conf file:
# TYPE  DATABASE        USER            ADDRESS                 METHOD
host all altcraft localhost password

Then go to the administrative panel for further customization.

Platform settings​

In the Admin panel, go to the Account Area — External data configuration section. It is necessary to create a new configuration for connecting to the database; to do this, click the Create button.

Select the connection type PostgreSQL. Specify the database name, host, port and credentials of the user created in PostgreSQL. To test the connection, click Test connection:

Add the created configuration to your account. To do this, edit your account and select the configuration in the Account databases item:

info

You can learn more about setting up connectors to databases here.

Last updated on Mar 12, 2026
Previous
Deduplication request settings
Next
Proxy server settings
  • PostgreSQL installation
  • User and database configuration
  • Platform settings
© 2015 - 2026 Altcraft, LLC. All rights reserved.