1. Information
2. Sign In
-
Browse to https://forge.laravel.com/sign-in.
-
Type
douwe@grendelgames.comin the Email field. -
Type the password in the Password field.
-
Click Continue
-
Select Grendel Games in the top left corner.
-
Optional: Browse to https://forge.laravel.com/grendel-games.
3. Usage
3.1. Create Server
-
See http://kb.grendelgames.com/books/engineering-handbook/page/how-to-setup-a-server-on-laravel-forge.
-
Select the Servers tab.
-
Select Create Server.
-
Type Name |
shared-dev-02. -
Select Provider | Grendel Games.
-
Select Share with | Grendel Games Development.
-
Click Continue.
-
Select Type | App server.
-
Select Region | Amsterdam, NL.
-
Select Server size | Tiny.
-
Expand Advanced settings.
-
Select Server OS | <Latest Ubuntu LTS version>.
-
Select PHP version | <Latest stable version>.
-
Select Database type | <Latest MySQL LTS version>.
-
Enable Add server’s SSH key to source control providers.
-
Click Update.
-
Click Create server.
-
Wait about 10 minutes for the server to become online.
-
Add the root SSH password and MySQL password to the Root Keypass database (or send to Erwin or Alex).
-
Setup DNS domain based on the assigned IP address
-
For most backends we create subdomain A records under grendelgames.com
-
Setup a Let’s Encrypt SSL certificate for this (sub)domain
-
Disable the redirect from www toggle, as we don’t use www records for backends.
3.2. Encrypted Server Storage
IMPORTANT If everything works correctly, from now on the server won’t boot until the decryption passphrase is given. This also means the SSH daemon won’t start, and you can’t connect through regular SSH. In order to decrypt the drive, connect through the Linode Shell (LISH) console. This is a native terminal that Linode exposes through SSH. You can find the address in the Linode web interface. The username/password you use are your Linode credentials. After connecting, it should show you the Ubuntu boot process where it asks for the decryption password
-
Browse to https://login.linode.com/login.
-
Select Linode | Three-dots menu > Launch LISH Console.
-
Log in with your Linode credentials.
3.3. Database Backup
-
Browse to https://forge.laravel.com/grendel-games.
-
Log in with your Grendel Games email account.
-
Select Grendel Games in the top left corner.
-
Select the Servers tab.
-
Select a server.
-
Select Backups | Edit configuration.
3.4. Private Network
3.5. SSH Key
-
Generate a private/public SSH key pair and store the keys in the Password Manager.
-
Browse to https://forge.laravel.com/grendel-games.
-
Select the Servers tab.
-
Select a server.
-
Select Settings > SSH.
-
Click Add key.
-
For Name type
Grendel<Name>. -
For Public key paste the public SSH key that is stored in KeePassXC.
Name GrendelDouwe User forge Public key ssh-ed25519 ######## douwe@grendelgames.com
-
Click Add.
ssh forge@139.177.182.227 # Check that public key matches the one listed under Settings in Forge Dashboard. cat .ssh/id_rsa.pubThe authenticity of host '139.177.182.227 (139.177.182.227)' can't be established. ED25519 key fingerprint is SHA256:Qrfl4DotMHmti6GtwCzPEU1sZUKn0AfgJR9Yuj/Y/+0. This key is not known by any other names. Are you sure you want to continue connecting (yes/no/[fingerprint])?
-
How to use.
3.6. Migration
Multiple Forge servers run on outdated version of Ubuntu Some on Ubuntu 18 or 20 Current LTS is 24
Upgrading may be non-trivial Laravel recommends provisioning a new server, and then migrating sites to that new server Sadly they do not provide instructions on how to perform such a migration There are some scripts that we could look into: https://github.com/pforret/forge-migrate Determine where DNS records for sites are kept to allow updating them post-migration Make a plan for actively used sites
3.7. Terra Troopers
-
The dev/test envirionments of Terra Troopers are hosted on the shared-dev-01 server.
IP: 139.177.182.227 ID: 468888 App server PHP 8.0 MySQL 8.0 Ubuntu 20.04 Public IP: 139.177.182.227 Private IP: 192.168.153.198
-
Browse to https://test.terratroopers.grendelgames.com/login.
Migration from Laravel Forge to Erasmus.