This project makes use of a tool called vmmmake to build all-in-one virtual machines that contain everything you need to run an Earth Eternal server game, such as Earth Eternal, Valkal's Shadow.
Logging in to to the VM, this is what you will see ...
It contains ..
- A lightweight Debian 12 based operating system.
- The redis database.
- The
tawdgame server. - Appropriate game Data and client assets.
- All required dependencies.
It is available for a number of different hypervisor platforms. Your provider should support one of these, with a fallback option of installing a generic ISO image.
- OVA (for VirtualBox, VMWare and others)
- HyperV (Windows)
- KVM (Proxmox etc)
- Docker (Many platforms include modern NAS devices)
- Generic ISO image (Debian Installer) may also be installed on dedicated 64-bit AMD/Intel hardware
The created VMs will also be easily updateable, both the operating system, the tawd server and game and client assets. Uses the familiar apt command.
There are 2 classes of virtual machine available. Cloud provider oriented ones, and on-prem. Use the recommended type for your provider or hypervisor.
Some of these files are compressed (zip, bzip or gzip). They expand to about 15GB, so ensure you have plenty of space before extracting them to import to your hypervisor.
On-prem images will generally involve you having your own Hypervisor software, although some cloud providers may provide ways to upload these images too.
| Platform | File Type | Download |
|---|---|---|
| VirtualBox and Others | OVA | tawd-vm-ova-0.9.0.ova |
| Any Hypervisor or Real Hardware | ISO | tawd-vm-debianlive-0.9.0.iso |
| HyperV | VHD (zipped) | tawd-vm-hyperv-0.9.0.zip |
| KVM (Linux, Proxmox etc) | QCOW2 (bzipped) | tawd-vm-kvm-0.9.0.bz2 |
For Cloud images, either upload the image to your provider, or in the case of Docker, you can "pull" the machine directly from Docker Hub.
| Platform | File Type | Download |
|---|---|---|
| Docker | Container | See project page emeraldicemoon/tawd |
| GCE | Raw Disk (gzipped) | tawd-vm-gce-0.9.0.gz |
Simply download the appropriate image for your provider and follow their instructions. Once you have a running virtual machine, you manage it as any other Debian based server.
- Install and start your machine.
- Login as
tawd, you will be prompted to create a VM login password. Keep this safe! - Use
apt updateto check if there are any updates, andapt upgradeif there are. - Use
eeaccountto create your game administrator account.
For more instructions on maintaining a server (creating accounts, shard configuration and more), see Running Your Own Server on the main project.
You can also find instructions there if you want to install on top of another operating system. In that case, you will have to setup redis and any other dependencies yourself. This is no longer the recommend method.
You will need vmmmake (which is a bit hard to obtain at the moment, it will be available in the future). These instructions are mostly for my purposes. It is highly unlikely you will ever need them.
vmmake -Pversion=0.9.0 --include=ova --workspace=/home/emerald/Desktop/my_workspace recipe.yml
-Pversionargument is used to when generating the final filename (ensuring they are versions).--includeargument is used to specify the target type. Other types includedebianlive(for the ISO image),kvm,docker, and more. See therecipe.ymlfile for more.--workspaceargument is to specify where the temporary build workspace is,and may be used to ensure the temporary workspace needed to build is located on a fast drive.
Look in artifacts directory for the results.
When publishing to Docker Hub, additional arguments must be passed for authentication.
vmmake -Pdocker.username=yourdockerusername -Pdocker.password=asecret -Pversion=0.9.0 \
--include=docker --workspace=/fast/cache/vmmake recipe.yml
You can buiuld all image types in one go if you like.
vmmake -X -Pversion=0.9.0 -Pdocker.username=yourdockerusername -Pdocker.password=asecret \
--include=ova,kvm,hyperv,docker,gce,debianlive \
--workspace=/fast/cache/vmmake recipe.yml