1. Initial Setup
Here is a list of things you will need to install on Windows or Linux depending on your setup.

Before Buying a Server

Who you should NOT USE for hosting Athena:
  • Zap
  • Iceline
  • ANY Pay Per Player Slot Provider
Why? These server providers do not give you direct access to the server in most cases. Athena requires additional setup through a terminal but also to install MongoDB to store data. Meaning that if you choose these hosting providers for your server. You are solely responsible for figuring out how to set them up.
Nobody in the Athena Discord will be providing you with instructions for your server host.

Obtain a License Key

Athena uses a licensing system for assisting with booting the framework.

Windows 10 / Windows Server

You need to download and install these programs and binaries from the links below.
When Installing MongoDB Keep Everything Default

Make Sure MongoDB is Running as a Service

Port Forwarding

At the very least you will need to open port 7788 for your main server.
You will need to open the following ports in your Windows Firewall and Router.
  • 7788
Here's a .bat script that will open both ports in your Windows Firewall.
1
ECHO OFF
2
3
echo Opening 7788 for TCP
4
netsh advfirewall firewall add rule name="alt:V-7788-IN-TCP" dir=in action=allow protocol=TCP localport=7788
5
netsh advfirewall firewall add rule name="alt:V-7788-OUT-TCP" dir=out action=allow protocol=TCP localport=7788
6
7
echo Opening 7788 for UDP
8
netsh advfirewall firewall add rule name="alt:V-7788-IN-UDP" dir=in action=allow protocol=UDP localport=7788
9
netsh advfirewall firewall add rule name="alt:V-7788-OUT-UDP" dir=out action=allow protocol=UDP localport=7788
10
11
pause
Copied!
If you need additional help with port forwarding in your router you should check out this Port Forward Website where you can find instructions for your router based on brand.

Linux Ubuntu 18.04

The recommended distro for alt:V is Ubuntu 18.04. You are going to need to perform a handful of Linux commands through a shell/terminal interface to fully utilize this framework. This can often be done with Putty on a Windows computer. Athena will only work with an unmanaged vps or unmanaged dedicated server.
What that means for you as an end-user is using one of the following services:

General Server Recommendation for Starting Out

This is just a general server recommendation for Linux Servers. If you can afford a OVH Game Server and have the player base for it; it is highly recommended for their anti-ddos services.
  • 2 Cores
  • 3+ GHz Processor
  • 4 - 32GB of RAM
  • Unmetered Incoming Bandwidth
  • Unmetered Outgoing Bandwidth
  • SSD 100GB~
  • Anti-DDoS Service

Port Forwarding

1
sudo ufw allow 7788
2
sudo ufw allow 9111
Copied!
Special Note: Your server host may have an additional firewall option in their control panel. Ensure you open your ports through there as well. OVH is known to have this feature.

Install libatomic1

This is used by alt:V
1
sudo apt-get install libatomic1
Copied!

Install GIT

Run the following commands to install GIT on Ubuntu 18.04
1
sudo apt install git
Copied!

Install NodeJS

Run the following commands to install NodeJS on Ubuntu 18.04
1
sudo apt install curl
Copied!
1
curl -sL https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.0/install.sh -o install_nvm.sh
Copied!
1
bash install_nvm.sh
Copied!
1
source ~/.bashrc
Copied!
1
nvm install 14
Copied!
1
node --version && npm --version
Copied!
NodeJS should be installed and both commands should return a version.

Install MongoDB

It is highly recommended you checkout how to setup a secure MongoDB instance through Digital Ocean's documentation as it will fit your needs. However, I've provided basic setup instructions below that works without authentication to the database.
Run the following commands to install MongoDB on Ubuntu 18.04.
1
wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
Copied!
1
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
Copied!
1
sudo apt-get update
Copied!
1
sudo apt-get install -y mongodb-org
Copied!

Running MongoDB

1
sudo systemctl start mongod
Copied!
If an error occurs try running this first:
1
sudo systemctl daemon-reload
Copied!

Checking Status of MongoDB

1
sudo systemctl status mongod
Copied!
Last modified 3mo ago