Installation guide

Installation Guide

This guide will walk you through the process of setting up your Placehodlr environment. Follow these steps carefully to ensure a successful installation.

Step 1: Sign Up and Create Account

1. Access the Frontend UI

   • Navigate to the browser dashboard:

   • The interface will guide you through initial setup

2. Create Your Account

   • Fill in your desired credentials

   • Follow the on-screen instructions to complete account creation

3. Get whitelisted

   • Network scripts are open to the network's whitelisted validators alone.

   • Once you register, reach out to your Network's Validator Support team or us directly to help us whitelist you into the network's group.

Step 2: Install Local Agent

1. Download Agent

   • Obtain the installation package from your welcome resources

   • Save it in a convenient location

2. Run Installation

   • Open your terminal

   • Navigate to the package directory

   cd /path/to/package/directory

   • Execute the installation script

   bash package.sh

3. OAuth Token Generation

   • The agent will automatically generate an OAuth token during installation

   • Save this token - you'll need it for the next step

   • Note: This token is crucial for securing the connection between your local agent and the browser dashboard.

4. Open port

   1. Only one port needed: 3000

Here are how your logs should look. If they look different, reach out to us and we will help you debug.

Step 3: Complete Handshake

1. Access Profile Settings

   • Log into the frontend application

   • Navigate to your profile section

2. Configure API Connection

   • Locate the API section in your profile

   • Input the OAuth token generated by your local agent

   • This establishes the secure connection between your local environment and the browser dashboard

Step 4: Access Your Dashboard

1. Launch Local Dashboard

   • Open your web browser

   • Navigate to: http://<your_public_ip>:3000

2. Initial Login Use the default credentials:

   • Username: admin

   • Password: changeme

Step 5: Secure Your Installation

1. Change Default Password

   • Log in to the Semaphore UI

   • Navigate to User Settings

   • Look for the password change option

   • Set a strong, unique password

Step 6: Important Notes

1. Project Names

   • Do not modify automatically generated project names

   • These names are used for internal reference and synchronization

2. Verification

   • Ensure all services are running properly

   • Check both local and browser dashboards are accessible

   • Verify the connection between your local agent and browser dashboard

Troubleshooting

If you encounter any issues during installation:

1. Check the agent installation logs

2. Verify the OAuth token was properly generated and input

3. Ensure all services are running on the expected ports

4. Contact support if issues persist

Next Steps

After successful installation:

1. Explore both local and browser dashboard interfaces

2. Review available community scripts

3. Run your first script

4. Connect with the validator community

Remember: The installation process is designed to be straightforward, but don't hesitate to reach out to support if you need assistance.