Setting up an AS2 & AS3 Club Penguin Private Server on Ubuntu 18.04

Hey

Here we have a guide on how to setup and host an AS2 or AS3 Club Penguin Private Server on a Virtual Private Server.

We will be using wand to set this up, which will install all of the necessary requirements for your CPPS and deploy your servers for you.

The software that wand installs for you is shown below.

  • NGINX as our web-server

  • PostgreSQL as our database server

  • Houdini as our Club Penguin server

  • Dash as a server for web-services (registration, avatar API etc)

  • Vanilla media-server - A client for the version of Club Penguin prior to its closure which was written in ActionScript 3

  • Legacy media-server - A client for the version of Club Penguin during 2008 which was written in ActionScript 2

Before we begin, you must have the following requirements.

REQUIREMENTS:

THE INITIALIZATION OF YOUR VPS

When buying a Virtual Private Server, it’ll usually prompt you with a question asking what OS you would like to install. You should choose Ubuntu 18.04 or a version higher than that.

The company you bought your VPS from would send your VPS details in the form of an email with the title: Your VPS installation

The email would typically be along the lines of:

Dear Customer,

Your VPS has just been installed on the following operating system/distribution
Ubuntu 18.04 Server (64-bit version)

ACCESS SETTINGS:
Your VPS’s IPv4 address is: VPSIP
Your VPS’s IPv6 address is: …

Your VPS name is: …

The following administrator account has been configured on the VPS:
Username: root
Password: MyVPSPassword

GETTING STARTED
If you are connecting to a VPS for the first time, we suggest that you refer to the following guide:
Getting started with a VPS - OVHcloud

MANAGEMENT, BILLING, SUPPORT
You can manage your VPS from your control panel
at the following address:
OVHcloud

TO GET HELP:
To assist you in getting started with your VPS, we provide you with
user guides:
https://www.ovh.co.uk/support/knowledge/

A large community of users are also available via our forum and our mailing lists here:
Help Centre - OVHcloud

Kind regards,
The OVH Team

Thank you for choosing OVH!

Kind regards,

The OVH team

Using a tool like PuTTy or Terminal (from the requirements), we can now login to the Virtual Private Server remotely.

macOS or linux users can open up terminal and type in the following:

ssh root@VPSIP

Windows users can use PuTTy, refer to this guide.

Both ways should prompt you with a password, which you obviously retrieve from the installation email.

Once you are logged in, you can execute the following commands on your server as shown in each step. When prompted with y/n, be sure to select y as you are agreeing to install a certain package on your VPS.

Step 1 Installing git, docker and docker-compose

sudo apt update

sudo apt install docker.io git curl

sudo curl -L “https://github.com/docker/compose/releases/download/1.25.5/docker-compose-$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

Step 2: Clone wand’s repository & submodules

git clone --recurse-submodules GitHub - solero/wand: Docker setup for Houdini && cd wand

Step 3 Edit your config file

nano .env

After executing this command, you’ll find yourself within an editor. All you have to do is fill in your configuration using the editor. Comments are left to explain what each variable is for.

When you are done, just hit CTRL+X on your keyboard which will close the file. It may ask if you would like to save the file, where in that case you should select yes by pressing y.

It may also ask where you want to save this file, which by default should show the correct filename that you editted (.env). Just click enter if it is correct.

Step 4 Start the services

sudo docker-compose up

Step 5 You’re done. Try visiting your play page’s sub-domain.

If it is successful, you can login with the default account installed:

Username: Basil
Password: password

If you ran into any issues, try reporting the issue in our discord server or if a specific error came up, try researching it on google.

Please remember you are more likely to get a quicker answer from google than waiting around for someone to reply.

Houdini-asyncio and Dash is currently in its testing stages, so if you’ve managed to find a bug, be sure to open an issue about it on the correct repository.

6 Likes

Very nice tutorial.

Hopefully this will help many AS3 fans.

1 Like