{"id":19,"date":"2023-01-08T01:31:06","date_gmt":"2023-01-07T22:31:06","guid":{"rendered":"https:\/\/akaunting.com\/hc\/docs\/on-premise\/installation\/"},"modified":"2024-12-16T14:24:24","modified_gmt":"2024-12-16T11:24:24","slug":"installation","status":"publish","type":"docs","link":"https:\/\/akaunting.com\/hc\/docs\/on-premise\/installation\/","title":{"rendered":"Installation"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Getting Akaunting up and running on your local or remote server takes a few minutes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The guide below will walk you through the process. The installation is a very simple process and takes less than five minutes to complete.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"#basic\">Basic instructions<\/a><\/li>\n\n\n\n<li><a href=\"#detailed\">Detailed instructions<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"#download\">Download and Extract<\/a><\/li>\n\n\n\n<li><a href=\"#database\">Database<\/a><\/li>\n\n\n\n<li><a href=\"#env\">Env<\/a><\/li>\n\n\n\n<li><a href=\"#installwizard\">Run the Install wizard<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><a href=\"#setupconfig\">Setup configuration file<\/a>\n<ul class=\"wp-block-list\">\n<li><a href=\"#launchinstaller\">Launching the installer<\/a><\/li>\n\n\n\n<li><a href=\"#selectinglanguage\">Selecting your language<\/a><\/li>\n\n\n\n<li><a href=\"#settingdatabase\">Setting up your database<\/a><\/li>\n\n\n\n<li><a href=\"#addingadmin\">Adding an admin<\/a><\/li>\n\n\n\n<li><a href=\"#login\">Login<\/a><\/li>\n\n\n\n<li><a href=\"#support\">Support<\/a><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li><a href=\"#npminstallerror\">NPM Install Error (Macbook)<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"basic\"><strong>Basic Instructions<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Here\u2019s a brief version of the instructions for those who are already familiar with performing such installations.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Visit <a href=\"https:\/\/akaunting.com\/download\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/akaunting.com\/download<\/a> to download the Akaunting package. <\/li>\n\n\n\n<li>Unzip the downloaded package.<\/li>\n\n\n\n<li>Create a database for Akaunting on your web server and a MySQL (or MariaDB) user with full privileges to access and modify it.<\/li>\n\n\n\n<li>(Optional) Rename <code>.env.example<\/code> to <code>.env<\/code> and edit the file (see Editing <code>.env)<\/code> to add your database information. <em><strong>Note:<\/strong> If you are not comfortable renaming files, you can skip this step, as the installation program will create the .env file for you.<\/em><\/li>\n\n\n\n<li>Upload the Akaunting files to the desired location on your web server:\n<ul class=\"wp-block-list\">\n<li>If you want to integrate Akaunting into the root of your domain (e.g., <code>https:\/\/example.com\/<\/code>) Move or upload all the contents of the unzipped Akaunting directory (excluding the Akaunting directory itself) into the root directory of your web server.<\/li>\n\n\n\n<li>If you want to have your Akaunting installation in its own subdirectory on your website (e.g., <code>https:\/\/example.com\/akaunting\/<\/code>), create a directory named akaunting on your server, and upload the contents of the unzipped Akaunting package to that directory via FTP. <em><strong>Note:<\/strong> If your FTP client has an option to convert file names to lowercase, make sure it\u2019s disabled.<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Run the Akaunting installation script by accessing the URL in a web browser. This should be the URL where you uploaded the Akaunting files:\n<ul class=\"wp-block-list\">\n<li>If you installed Akaunting in the root directory, visit: <code>https:\/\/example.com\/<\/code><\/li>\n\n\n\n<li>If you installed Akaunting in its own subdirectory, for example <code>akaunting<\/code>, visit: <code>https:\/\/example.com\/akaunting\/<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>That\u2019s it! Akaunting should now be installed.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"detailed\"><strong>Detailed instructions<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"download\"><strong>Step 1: Download and Extract<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Download and unzip the Akaunting from <a href=\"https:\/\/akaunting.com\/download.\">https:\/\/akaunting.com\/download.<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"database\"><strong>Step 2: Database<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If you only have one database and it is already in use, you can install Akaunting in that database. Akaunting uses a distinct prefix for each installation to avoid overwriting existing database tables.<\/li>\n\n\n\n<li>To create a new database, follow the instructions below for using phpMyAdmin.<\/li>\n\n\n\n<li>Create a new database:\n<ul class=\"wp-block-list\">\n<li>On the phpMyAdmin home page, click on the &#8220;Databases&#8221; tab in the left-hand panel.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"492\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-1024x492.png\" alt=\"\" class=\"wp-image-2658\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-1024x492.png 1024w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-300x144.png 300w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-768x369.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931.png 1167w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\n<ul class=\"wp-block-list\">\n<li>Enter a name for your new database in the \u201cDatabase name\u201d field. Your database name should be short and meaningful, e.g., akaunting or my_new_database. Select a \u201cCollation\u201d from the drop-down menu. Collation defines the character set your database will support. Generally, \u201c<code>utf8mb4_general_ci<\/code>\u201d or \u201c<code>utf8_general_ci<\/code>\u201d are good choices.<\/li>\n\n\n\n<li>Click the \u201cCreate\u201d button to create your database.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"492\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-1024x492.png\" alt=\"\" class=\"wp-image-2659\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-1024x492.png 1024w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-300x144.png 300w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931-768x369.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105208\/Ekran-goruntusu-2024-07-24-121931.png 1167w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"env\"><strong>Step 3: Env<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>You can either create and edit the <code>.env<\/code> file yourself, or you can skip this step and let Akaunting attempt to create and configure it automatically when you run the installation script (Step 4). (You will still need to provide Akaunting with your database information.)<\/li>\n\n\n\n<li>Return to where you extracted the Akaunting in Step 1, rename the file <code>.env.example<\/code> to .<code>env<\/code>, and open it in a text editor.\n<ul class=\"wp-block-list\">\n<li><strong>APP_URL<\/strong>: The base URL of the application used to generate URLs and links.<\/li>\n\n\n\n<li><strong>APP_KEY<\/strong>: A random, secret key used for encrypting data and securing the application.<\/li>\n\n\n\n<li><strong>DB_CONNECTION<\/strong>: Specifies the type of database connection (e.g., mysql, pgsql).<\/li>\n\n\n\n<li><strong>DB_HOST<\/strong>: The IP address or hostname of the database server.<\/li>\n\n\n\n<li><strong>DB_PORT<\/strong>: The port number for connecting to the database server (e.g., 3306, 5432).<\/li>\n\n\n\n<li><strong>DB_DATABASE<\/strong>: The name of the database to be used.<\/li>\n\n\n\n<li><strong>DB_USERNAME<\/strong>: The username for connecting to the database.<\/li>\n\n\n\n<li><strong>DB_PASSWORD<\/strong>: The password for the database user account.<\/li>\n\n\n\n<li><strong>DB_PREFIX<\/strong>: A prefix to be added to database table names to prevent name collisions between multiple applications.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<figure class=\"wp-block-image size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"510\" height=\"361\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105610\/Adsiz-12.jpg\" alt=\"\" class=\"wp-image-2660\" style=\"width:840px;height:auto\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105610\/Adsiz-12.jpg 510w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/30105610\/Adsiz-12-300x212.jpg 300w\" sizes=\"auto, (max-width: 510px) 100vw, 510px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Note<\/strong>: When you manually update the <code>.env<\/code> information, there must be a previous Akaunting installation in the database. Otherwise, your installation  will not work.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"installwizard\"><strong>Step 4: Run the Install wizard<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Point a web browser to start the installation script.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>If you placed the Akaunting files in the root directory, you should visit: https:\/\/example.com<\/li>\n\n\n\n<li><span style=\"color: initial; font-family: -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot;, Roboto, Oxygen-Sans, Ubuntu, Cantarell, &quot;Helvetica Neue&quot;, sans-serif;\">If you placed the Akaunting files in a subdirectory called blog, for example, you should visit: <\/span><code style=\"background-color: rgb(255, 255, 255); color: initial; font-size: 18px;\">https:\/\/example.com\/akaunting\/<\/code><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"setupconfig\"><strong>Setup configuration file<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you have manually created the <code>.env<\/code> file, you will be redirected directly to the login page, bypassing the installation page.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"launchinstaller\"><strong>Launching the Installer<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Enter&nbsp;<code>http:\/\/your-domain\/akaunting-directory<\/code>&nbsp;in your browser.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This will launch the installation wizard. The installation wizard takes you through the following steps.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Select your language<\/li>\n\n\n\n<li>Set up your database.<\/li>\n\n\n\n<li>Add an admin<\/li>\n\n\n\n<li>Login<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"selectinglanguage\"><strong>Selecting Your Language<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Select your preferred language.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"829\" height=\"1024\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language-829x1024.png\" alt=\"Selecting your language\" class=\"wp-image-1417\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language-829x1024.png 829w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language-243x300.png 243w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language-768x948.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language-1244x1536.png 1244w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104610\/Step-1-Language.png 1328w\" sizes=\"auto, (max-width: 829px) 100vw, 829px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Akaunting is available in 50+ languages.<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"settingdatabase\"><strong>Setting up your database<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Add the database connection details &#8211; Hostname, Username, Password, and Database Name.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"829\" height=\"1024\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database-829x1024.png\" alt=\"Setting up your database\" class=\"wp-image-1418\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database-829x1024.png 829w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database-243x300.png 243w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database-768x948.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database-1244x1536.png 1244w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104713\/Step-2-Database.png 1328w\" sizes=\"auto, (max-width: 829px) 100vw, 829px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><\/h3>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"addingadmin\"><strong>Adding an Admin<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can add the Company Name &amp; E-mail and create a new Administration account.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"829\" height=\"1024\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin-829x1024.png\" alt=\"Add an Admin\" class=\"wp-image-1419\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin-829x1024.png 829w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin-243x300.png 243w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin-768x948.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin-1244x1536.png 1244w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104816\/Step-3-Admin.png 1328w\" sizes=\"auto, (max-width: 829px) 100vw, 829px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"login\"><strong>Login<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">After installing, you can log into the admin panel with your account details.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"829\" height=\"1024\" src=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login-829x1024.png\" alt=\"Login to admin\" class=\"wp-image-1420\" srcset=\"https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login-829x1024.png 829w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login-243x300.png 243w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login-768x948.png 768w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login-1244x1536.png 1244w, https:\/\/assets.akaunting.com\/hc\/2023\/01\/19104901\/Step-4-Login.png 1328w\" sizes=\"auto, (max-width: 829px) 100vw, 829px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Check out <a href=\"https:\/\/akaunting.com\/hc\/docs\/on-premise\/getting-the-api-key\/\" target=\"_blank\" rel=\"noreferrer noopener\">How to get your API key<\/a> and <a href=\"https:\/\/akaunting.com\/hc\/docs\/on-premise\/setting-up-your-company\/\" target=\"_blank\" rel=\"noreferrer noopener\">Set up your Company<\/a><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"support\"><strong>Support<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">You can contact us for <a href=\"https:\/\/akaunting.com\/dedicated-support\" target=\"_blank\" rel=\"noreferrer noopener\">Dedicated Support<\/a> if there are any installation issues.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"npminstallerror\"><strong>NPM Install Error<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">While installing Akaunting on your MacBook (Apple Silicon), you may experience an NPM Install Error. Here&#8217;s a reference on <a href=\"https:\/\/github.com\/akaunting\/akaunting\/issues\/3232#issuecomment-2533742687\" target=\"_blank\" rel=\"noopener\">how to resolve the error<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Getting Akaunting up and running on your local or remote server takes a few minutes. The guide below will walk you through the process. The installation is a very simple process and takes less than five minutes to complete. Basic Instructions Here\u2019s a brief version of the instructions for those who are already familiar with [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":8,"menu_order":3,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-19","docs","type-docs","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/docs\/19","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/comments?post=19"}],"version-history":[{"count":10,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/docs\/19\/revisions"}],"predecessor-version":[{"id":3269,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/docs\/19\/revisions\/3269"}],"up":[{"embeddable":true,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/docs\/8"}],"wp:attachment":[{"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/media?parent=19"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/akaunting.com\/hc\/wp-json\/wp\/v2\/doc_tag?post=19"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}