{"_id":"5ea1de03eacb21024b9df550","order":0,"title":"Getting Started","createdAt":"2015-01-29T01:43:40.744Z","hidden":false,"isReference":false,"link_external":false,"updates":["54d3fb1fae3d0f0d00f0060b","54ed88432a6fa23700660c83","556f6c619893290d00988cb3","55baa1133f0767230008f46e","562e4b2b4376430d006f17af","5675b33570f07a0d0063223e","5675b4c370f07a0d0063223f","57629b305cacae2b003ab759","5873dec29cd5c725004f674e","5873dee21d09ed2500b8a828","5873e3363b5d851900b50e4d","588aa91f6a263e0f008eef17","588aa9a0b39ea10f0047a849","5898ad095196950f00e7953b","5898ad797c5f330f009109af","58f69a30afa6920f00dd5e77","599eb8247c48d8002381d4b3","59de4bfe5e7f1500106cd80d","5a6a979f3d228c001e83d99e","5a6bf6622116e20022de8f30"],"body":"[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"**This application is intended for experienced system administrators and is not intended to be setup on a local home computer.**\",\n  \"title\": \"Warning:\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If you run into any issues during the setup process, check the [FAQ page](https://docs.solder.io/v0.7.6/docs/faq-frequently-asked-questions)\"\n}\n[/block]\nNeed help with Solder? Pop into our [Technic Development Discord](https://discord.gg/0XSjZibQg6yguy1x) chat channel!\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Before You Begin\"\n}\n[/block]\nYou will need to setup your server with a proper software stack. Technic recommends a LEMP stack. This stands for Linux OS, (E)Nginx web server, MySQL database server, and PHP. Here are some great guides from Digital Ocean:\n\n- **Master list:** https://www.digitalocean.com/community/tutorial_collections/26\n\n- **Ubuntu 18.04:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mysql-php-lemp-stack-ubuntu-18-04\n- **Debian 10:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mariadb-php-lemp-stack-on-debian-10\n- **Arch Linux:** https://www.digitalocean.com/community/tutorials/how-to-install-lemp-nginx-mysql-php-stack-on-arch-linux\n- **CentOS 8:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mysql-php-lemp-stack-on-centos-8\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Installing on Windows is not supported and no help will be provided. If you try, you're on your own.\",\n  \"title\": \"Warning:\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Requirements\"\n}\n[/block]\n- Git\n- PHP >= 7.2.0\n- Composer - <https://getcomposer.org/>\n- BCMath PHP extension\n- cURL PHP extension\n- Ctype PHP extension\n- Fileinfo PHP extension\n- JSON PHP extension\n- Mbstring PHP extension\n- OpenSSL PHP extension\n- PDO PHP extension\n- Redis PHP extension\n- Tokenizer PHP extension\n- XML PHP extension\n- ZIP PHP extension\n- A MySQL/MariaDB or PostgreSQL database\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"sudo apt install git php7.2 php7.2-bcmath php7.2-cli php7.2-curl php7.2-fpm php7.2-json php7.2-mbstring php7.2-mysql php-redis php7.2-xml php7.2-zip\",\n      \"language\": \"shell\",\n      \"name\": \"Ubuntu/Debian\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Composer\"\n}\n[/block]\nSolder uses Composer. Composer is a tool for dependency management in PHP. It allows you to declare the dependent libraries your project needs and it will install them in your project for you.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"When using the following guides, do not create your own composer.json file, or perform \\\"composer install\\\" or \\\"php composer.phar install\\\" commands. These are handled later in this Getting Started guide.\",\n  \"title\": \"Note:\"\n}\n[/block]\n- Linux/Unix/Mac OS X: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Installing the program globally is recommended to ensure proper execution.\",\n  \"title\": \"Note:\"\n}\n[/block]\nBefore using Composer make sure to check for updates.\n\n- If you installed Composer locally: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"sudo php composer.phar self-update\",\n      \"language\": \"shell\",\n      \"name\": \"Local Composer\"\n    }\n  ]\n}\n[/block]\n- If you installed it globally: \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"sudo composer self-update\",\n      \"language\": \"shell\",\n      \"name\": \"Global Composer\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"General Setup\"\n}\n[/block]\nYou can setup Solder by cloning the GitHub repository and running a Composer command. Cloning the GitHub repository will create a folder called \"TechnicSolder\" in the directory where you ran the command. \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Please make sure you are running the git clone command where you want to Solder directory to be located. Copying the folder can break the GitHub link that provides Solder's ability to update\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"git clone https://github.com/TechnicPack/TechnicSolder.git\",\n      \"language\": \"shell\",\n      \"name\": \"HTTP (recommended)\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note:\",\n  \"body\": \"If you prefer the cloned directory to be named differently, append the name to the git command. (ex. `git clone https://github.com/TechnicPack/TechnicSolder.git <folder-name>`)\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If you prefer to test dev changes, add `-b dev` to the clone command. This will clone the development branch instead of the master branch.\",\n  \"title\": \"Note:\"\n}\n[/block]\nNow install the application from the root of the solder folder.\n\n- If you installed Composer locally:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php composer.phar install --no-dev --no-interaction\",\n      \"language\": \"text\",\n      \"name\": \"Local Composer\"\n    }\n  ]\n}\n[/block]\n- If you installed it globally:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"composer install --no-dev --no-interaction\",\n      \"language\": \"text\",\n      \"name\": \"Global Composer\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note:\",\n  \"body\": \"If you cloned the development branch, you can remove the `--no-dev` argument to install development tools.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Configuring Solder\"\n}\n[/block]\nNow, we need to configure Solder. For that, Solder uses a `.env` file, which specifies your environment configuration variables. Let's create one for us:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"cp .env.example .env\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nOpen the `.env` file we just created in your favorite text editor.\n\nInside, there's a bunch of variables, some of which we'll need to change.\n\nVariables are 1 per each line, and they have the format `name=value`.\n\nLook at the table below and change the variables to configure your Solder. You should leave any variables that aren't in this table with the values they already have.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Variable name\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"APP_URL\",\n    \"0-1\": \"The URL where Solder will be at (like https://solder.technicpack.net)\",\n    \"1-0\": \"DB_CONNECTION\",\n    \"1-1\": \"The type of database you're using. For MySQL, this is \\\"mysql\\\". For PostgreSQL, this is \\\"pgsql\\\"\",\n    \"2-0\": \"DB_HOST\",\n    \"2-1\": \"The IP of your database server. This is 127.0.0.1 if you're running it on the same server.\",\n    \"3-0\": \"DB_PORT\",\n    \"3-1\": \"Your database server port. 3306 for MySQL, 5432 for PostgreSQL.\",\n    \"4-0\": \"DB_DATABASE\",\n    \"4-1\": \"The name of your database.\",\n    \"5-0\": \"DB_USERNAME\",\n    \"5-1\": \"The username to access your database.\",\n    \"6-0\": \"DB_PASSWORD\",\n    \"6-1\": \"The password to access your database.\",\n    \"7-0\": \"CACHE_DRIVER\",\n    \"7-1\": \"Where Solder will store temporary stuff. This can be \\\"file\\\", and it will store stuff as files, but \\\"redis\\\" (and having a Redis server) is recommended.\",\n    \"8-0\": \"SESSION_DRIVER\",\n    \"8-1\": \"Same as CACHE_DRIVER, except for PHP sessions.\",\n    \"9-0\": \"REDIS_HOST\",\n    \"9-1\": \"If you're using Redis, the IP of your Redis.\",\n    \"10-0\": \"REDIS_PASSWORD\",\n    \"10-1\": \"The password to your Redis, if one is set.\",\n    \"11-0\": \"REDIS_PORT\",\n    \"11-1\": \"If you're using Redis, your Redis port.\",\n    \"12-0\": \"SOLDER_REPO_LOCATION\",\n    \"12-1\": \"Your Solder repo location (see below)\",\n    \"13-0\": \"SOLDER_MIRROR_URL\",\n    \"13-1\": \"Your Solder mirror URL (see below)\",\n    \"14-0\": \"SOLDER_MD5_CONNECT_TIMEOUT\",\n    \"14-1\": \"The remote MD5 timeout (see below)\"\n  },\n  \"cols\": 2,\n  \"rows\": 15\n}\n[/block]\n- **Repo location:** This points to the location of your repo files either locally or remotely. If your Solder install is on the same box as your mod repository, you can fill in the absolute path to those files. This will greatly increase the speed in which md5's are calculated for your database. If your mod repository is hosted elsewhere, you can simply put the web accessible URL in for this value. Make sure to include a trailing slash in *both* cases.\n- **Mirror URL:** The mirror url is the web accessible url to your mod repository. If you are using a URL for your repo location you can just fill in the same value here.\n- **Remote MD5 timeout:** This is the amount of time Solder will wait before giving up trying to calculate the MD5 checksum on a remote repo location.\n\nYour Solder needs to have an application encryption key set so it can properly function. To do this, use the following command, which will automatically set generate a key for you and set it in `.env` (under `APP_KEY`):\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php artisan key:generate\",\n      \"language\": \"shell\"\n    }\n  ]\n}\n[/block]\nPlatform API Keys are now handled through the application itself. See \"Configure Solder -> API Key Management\"\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Database Configuration\"\n}\n[/block]\nYou must create a database for Solder. The default name is \"solder\".\n\nInstructions for setting up a database server and creating a database aren't provided in this guide, as they vary depending on which database server you're using.\n\nOnce your database connection is setup and working, Solder has a built in migration tool that creates all of the required tables and data required to get Solder up and running.\n\nAs Solder updates and changes, you will use this command to pull in any changes made to Solder tables/data structure. You must run this command now to set up the database.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"\\\"Application In Production!\\\"\",\n  \"body\": \"When running this command you will probably get a \\\"Do you really wish to run this command?\\\" prompt, because Solder is running in production mode. It's perfectly safe to answer \\\"yes\\\".\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"php artisan migrate\",\n      \"language\": \"shell\",\n      \"name\": \"Migrate examples\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Web Server Configuration\"\n}\n[/block]\nYour final step is to make sure your web server is configured properly to handle traffic to Solder and its PHP files.\n\nYou should have already setup nginx (or Apache) and PHP following the guides provided above.\n\n**See the Example Web Server Configs page for examples in configuring your web server for Solder: [Example Web Server configs](doc:example-web-server-configs)**\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"File Permissions\",\n  \"body\": \"Your web server requires read access to the entire Solder folder. It also requires read & write access to the following directories:\\n\\n- \\\"/storage\\\"\\n\\nMake sure you have the proper permissions set when before attempting to access Solder. \\n\\nReference: https://www.digitalocean.com/community/tutorials/an-introduction-to-linux-permissions\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"If you use HTTPS, read this\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"About HTTPS and load balancers\",\n  \"body\": \"If you're using HTTPS, you'll want to make sure you set your URL in `APP_URL` to start with `https://`.\\n\\nIf your Solder instance is behind a load balancer that terminates TLS/SSL connections (like Cloudflare), then you will need to specify `protected $proxies = '*';` in your `app/Http/Middleware/TrustProxies.php` file. Unfortunately, this is the only fix available since your web server won't know the request should be HTTPS and it'll generate mixed content issues as Solder/Laravel will generate HTTP URLs.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Default Credentials\"\n}\n[/block]\nOnce you have Solder configured, just access it at the URL you set it up on and log in.\n\nThe default user information is:\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Credentials\",\n  \"body\": \"Email: admin:::at:::admin.com\\nPassword: admin\"\n}\n[/block]\nChange this information as soon as you log in!","githubsync":"","link_url":"","__v":75,"api":{"auth":"required","params":[],"results":{"codes":[]},"settings":"","url":""},"excerpt":"Technic Solder is a server-side PHP application based on the Laravel Framework. Its main goal is to provide differential updates for the Technic Launcher to process. This can include any type of file. Another goal is to process file check-sums to ensure the receiver is obtaining unaltered files.","sync_unique":"","type":"basic","user":"54c66cc52b94bb19003d3423","version":"5ea1de03eacb21024b9df557","category":"5ea1de03eacb21024b9df543","project":"54c66cdf2b94bb19003d3424","slug":"getting-started","next":{"pages":[],"description":""},"metadata":{"title":"","description":"","image":[]},"parentDoc":null,"childrenPages":[]}

Getting Started

Technic Solder is a server-side PHP application based on the Laravel Framework. Its main goal is to provide differential updates for the Technic Launcher to process. This can include any type of file. Another goal is to process file check-sums to ensure the receiver is obtaining unaltered files.

[block:callout] { "type": "danger", "body": "**This application is intended for experienced system administrators and is not intended to be setup on a local home computer.**", "title": "Warning:" } [/block] [block:callout] { "type": "info", "body": "If you run into any issues during the setup process, check the [FAQ page](https://docs.solder.io/v0.7.6/docs/faq-frequently-asked-questions)" } [/block] Need help with Solder? Pop into our [Technic Development Discord](https://discord.gg/0XSjZibQg6yguy1x) chat channel! [block:api-header] { "type": "basic", "title": "Before You Begin" } [/block] You will need to setup your server with a proper software stack. Technic recommends a LEMP stack. This stands for Linux OS, (E)Nginx web server, MySQL database server, and PHP. Here are some great guides from Digital Ocean: - **Master list:** https://www.digitalocean.com/community/tutorial_collections/26 - **Ubuntu 18.04:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mysql-php-lemp-stack-ubuntu-18-04 - **Debian 10:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mariadb-php-lemp-stack-on-debian-10 - **Arch Linux:** https://www.digitalocean.com/community/tutorials/how-to-install-lemp-nginx-mysql-php-stack-on-arch-linux - **CentOS 8:** https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mysql-php-lemp-stack-on-centos-8 [block:callout] { "type": "warning", "body": "Installing on Windows is not supported and no help will be provided. If you try, you're on your own.", "title": "Warning:" } [/block] [block:api-header] { "type": "basic", "title": "Requirements" } [/block] - Git - PHP >= 7.2.0 - Composer - <https://getcomposer.org/> - BCMath PHP extension - cURL PHP extension - Ctype PHP extension - Fileinfo PHP extension - JSON PHP extension - Mbstring PHP extension - OpenSSL PHP extension - PDO PHP extension - Redis PHP extension - Tokenizer PHP extension - XML PHP extension - ZIP PHP extension - A MySQL/MariaDB or PostgreSQL database [block:code] { "codes": [ { "code": "sudo apt install git php7.2 php7.2-bcmath php7.2-cli php7.2-curl php7.2-fpm php7.2-json php7.2-mbstring php7.2-mysql php-redis php7.2-xml php7.2-zip", "language": "shell", "name": "Ubuntu/Debian" } ] } [/block] [block:api-header] { "type": "basic", "title": "Composer" } [/block] Solder uses Composer. Composer is a tool for dependency management in PHP. It allows you to declare the dependent libraries your project needs and it will install them in your project for you. [block:callout] { "type": "info", "body": "When using the following guides, do not create your own composer.json file, or perform \"composer install\" or \"php composer.phar install\" commands. These are handled later in this Getting Started guide.", "title": "Note:" } [/block] - Linux/Unix/Mac OS X: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx [block:callout] { "type": "info", "body": "Installing the program globally is recommended to ensure proper execution.", "title": "Note:" } [/block] Before using Composer make sure to check for updates. - If you installed Composer locally: [block:code] { "codes": [ { "code": "sudo php composer.phar self-update", "language": "shell", "name": "Local Composer" } ] } [/block] - If you installed it globally: [block:code] { "codes": [ { "code": "sudo composer self-update", "language": "shell", "name": "Global Composer" } ] } [/block] [block:api-header] { "type": "basic", "title": "General Setup" } [/block] You can setup Solder by cloning the GitHub repository and running a Composer command. Cloning the GitHub repository will create a folder called "TechnicSolder" in the directory where you ran the command. [block:callout] { "type": "warning", "body": "Please make sure you are running the git clone command where you want to Solder directory to be located. Copying the folder can break the GitHub link that provides Solder's ability to update" } [/block] [block:code] { "codes": [ { "code": "git clone https://github.com/TechnicPack/TechnicSolder.git", "language": "shell", "name": "HTTP (recommended)" } ] } [/block] [block:callout] { "type": "info", "title": "Note:", "body": "If you prefer the cloned directory to be named differently, append the name to the git command. (ex. `git clone https://github.com/TechnicPack/TechnicSolder.git <folder-name>`)" } [/block] [block:callout] { "type": "info", "body": "If you prefer to test dev changes, add `-b dev` to the clone command. This will clone the development branch instead of the master branch.", "title": "Note:" } [/block] Now install the application from the root of the solder folder. - If you installed Composer locally: [block:code] { "codes": [ { "code": "php composer.phar install --no-dev --no-interaction", "language": "text", "name": "Local Composer" } ] } [/block] - If you installed it globally: [block:code] { "codes": [ { "code": "composer install --no-dev --no-interaction", "language": "text", "name": "Global Composer" } ] } [/block] [block:callout] { "type": "info", "title": "Note:", "body": "If you cloned the development branch, you can remove the `--no-dev` argument to install development tools." } [/block] [block:api-header] { "type": "basic", "title": "Configuring Solder" } [/block] Now, we need to configure Solder. For that, Solder uses a `.env` file, which specifies your environment configuration variables. Let's create one for us: [block:code] { "codes": [ { "code": "cp .env.example .env", "language": "shell" } ] } [/block] Open the `.env` file we just created in your favorite text editor. Inside, there's a bunch of variables, some of which we'll need to change. Variables are 1 per each line, and they have the format `name=value`. Look at the table below and change the variables to configure your Solder. You should leave any variables that aren't in this table with the values they already have. [block:parameters] { "data": { "h-0": "Variable name", "h-1": "Description", "0-0": "APP_URL", "0-1": "The URL where Solder will be at (like https://solder.technicpack.net)", "1-0": "DB_CONNECTION", "1-1": "The type of database you're using. For MySQL, this is \"mysql\". For PostgreSQL, this is \"pgsql\"", "2-0": "DB_HOST", "2-1": "The IP of your database server. This is 127.0.0.1 if you're running it on the same server.", "3-0": "DB_PORT", "3-1": "Your database server port. 3306 for MySQL, 5432 for PostgreSQL.", "4-0": "DB_DATABASE", "4-1": "The name of your database.", "5-0": "DB_USERNAME", "5-1": "The username to access your database.", "6-0": "DB_PASSWORD", "6-1": "The password to access your database.", "7-0": "CACHE_DRIVER", "7-1": "Where Solder will store temporary stuff. This can be \"file\", and it will store stuff as files, but \"redis\" (and having a Redis server) is recommended.", "8-0": "SESSION_DRIVER", "8-1": "Same as CACHE_DRIVER, except for PHP sessions.", "9-0": "REDIS_HOST", "9-1": "If you're using Redis, the IP of your Redis.", "10-0": "REDIS_PASSWORD", "10-1": "The password to your Redis, if one is set.", "11-0": "REDIS_PORT", "11-1": "If you're using Redis, your Redis port.", "12-0": "SOLDER_REPO_LOCATION", "12-1": "Your Solder repo location (see below)", "13-0": "SOLDER_MIRROR_URL", "13-1": "Your Solder mirror URL (see below)", "14-0": "SOLDER_MD5_CONNECT_TIMEOUT", "14-1": "The remote MD5 timeout (see below)" }, "cols": 2, "rows": 15 } [/block] - **Repo location:** This points to the location of your repo files either locally or remotely. If your Solder install is on the same box as your mod repository, you can fill in the absolute path to those files. This will greatly increase the speed in which md5's are calculated for your database. If your mod repository is hosted elsewhere, you can simply put the web accessible URL in for this value. Make sure to include a trailing slash in *both* cases. - **Mirror URL:** The mirror url is the web accessible url to your mod repository. If you are using a URL for your repo location you can just fill in the same value here. - **Remote MD5 timeout:** This is the amount of time Solder will wait before giving up trying to calculate the MD5 checksum on a remote repo location. Your Solder needs to have an application encryption key set so it can properly function. To do this, use the following command, which will automatically set generate a key for you and set it in `.env` (under `APP_KEY`): [block:code] { "codes": [ { "code": "php artisan key:generate", "language": "shell" } ] } [/block] Platform API Keys are now handled through the application itself. See "Configure Solder -> API Key Management" [block:api-header] { "type": "basic", "title": "Database Configuration" } [/block] You must create a database for Solder. The default name is "solder". Instructions for setting up a database server and creating a database aren't provided in this guide, as they vary depending on which database server you're using. Once your database connection is setup and working, Solder has a built in migration tool that creates all of the required tables and data required to get Solder up and running. As Solder updates and changes, you will use this command to pull in any changes made to Solder tables/data structure. You must run this command now to set up the database. [block:callout] { "type": "info", "title": "\"Application In Production!\"", "body": "When running this command you will probably get a \"Do you really wish to run this command?\" prompt, because Solder is running in production mode. It's perfectly safe to answer \"yes\"." } [/block] [block:code] { "codes": [ { "code": "php artisan migrate", "language": "shell", "name": "Migrate examples" } ] } [/block] [block:api-header] { "type": "basic", "title": "Web Server Configuration" } [/block] Your final step is to make sure your web server is configured properly to handle traffic to Solder and its PHP files. You should have already setup nginx (or Apache) and PHP following the guides provided above. **See the Example Web Server Configs page for examples in configuring your web server for Solder: [Example Web Server configs](doc:example-web-server-configs)** [block:callout] { "type": "warning", "title": "File Permissions", "body": "Your web server requires read access to the entire Solder folder. It also requires read & write access to the following directories:\n\n- \"/storage\"\n\nMake sure you have the proper permissions set when before attempting to access Solder. \n\nReference: https://www.digitalocean.com/community/tutorials/an-introduction-to-linux-permissions" } [/block] [block:api-header] { "title": "If you use HTTPS, read this" } [/block] [block:callout] { "type": "danger", "title": "About HTTPS and load balancers", "body": "If you're using HTTPS, you'll want to make sure you set your URL in `APP_URL` to start with `https://`.\n\nIf your Solder instance is behind a load balancer that terminates TLS/SSL connections (like Cloudflare), then you will need to specify `protected $proxies = '*';` in your `app/Http/Middleware/TrustProxies.php` file. Unfortunately, this is the only fix available since your web server won't know the request should be HTTPS and it'll generate mixed content issues as Solder/Laravel will generate HTTP URLs." } [/block] [block:api-header] { "type": "basic", "title": "Default Credentials" } [/block] Once you have Solder configured, just access it at the URL you set it up on and log in. The default user information is: [block:callout] { "type": "info", "title": "Credentials", "body": "Email: [email protected]\nPassword: admin" } [/block] Change this information as soon as you log in!