Login with your credentials and follow the instruction.
On the subscription page, subscribe to the product and Click on Continue to configuration button on top right corner.
Select a Region where you want to launch the VM(such as US East (N.Virginia))
Click on Continue to Launch Button.
Choose Action: You can launch it through EC2 or from Website.(Let’s choose Launch from website)
Optionally change the EC2 instance type. (This defaults to t2.xlarge instance type, 4 vCPUs and 16 GB RAM)
Optionally change the network name and subnetwork names.
Select the Security Group. Be sure that whichever Security Group you specify have ports 22 (for SSH), 3389 (for RDP) and 443 (for HTTPS) exposed. Or you can create the new Security Group by Clicking the Create New based on seller settings.
Be sure to download the key-pair which is available by default, or you can create the new key-pair and download it.
Click on Launch..
Onyx:GPT to chat & query your own data will begin deploying.
A summary page displays.To see this instance on EC2 Console click on EC2 Console link.
On the EC2 Console page, instance is up and running. To connect to this instance through putty, copy the IPv4 Public IP Address
Open putty, paste the IP address and browse your private key you downloaded while deploying the VM, by going to SSH->Auth, click on Open.
login as ubuntu.
run below command to update the ubuntu password.
sudo passwd ubuntu
Now the password for ubuntu user is set, you can connect to the VM’s desktop environment from any local windows machine using RDP protocol or local linux machine using Remmina.
To connect using RDP via Windows Machine, first note the public IP address of the VM from VM details page as highlighted below
Then From you local windows machine, goto “start” menu, in the search box type and select “Remote desktop connection”.
In the “Remote Desktop connection” wizard, copy the public IP address and click connect
This will connect you to the VM’s desktop environment. Provide the username (e.g “ubuntu”) and the password set in the step7 to authenticate. Click OK
Now you are connected to the out of box Onyx VM desktop environment via Windows Machine.
To connect using RDP via Linux machine, first note the external IP of the VM from VM details page,then from your local Linux machine, goto menu, in the search box type and select “Remmina”.
Note: If you don’t have Remmina installed on your Linux machine, firstInstall Remmina as per your linux distribution.
In the “Remmina Remote Desktop Client” wizard, select the RDP option from dropdown and paste the external ip and click enter.
This will connect you to the VM’s desktop environment. Provide “ubuntu” as the userid and the password set in above reset password step to authenticate. Click OK
Now you are connected to out of box Onyx VM desktop environment via Linux machine.
To access the Onyx GUI environment via browser, Copy the Public IP address of the VM from the VM’s details page and enter the address as http://vm_public_ip/ in the browser. Hit enter.
Note: Please use http and not https in the URL when accessing Onyx GUI, e.g. http://35.223.255.180/
When accessing the UI for the first time , click on the create an account link on the login page, provide your email id and password and hit Create Account button. This will create the first user with admin role.
Note: You can also limit the new user registration for specific domain. Please follow
How to secure user registration page for more details.
After your first login finish the setup by providing Name, model provider of your choice available on the home page. or you can add them later from the Admin Page.
Note: Before proceeding to use the Onyx AI functionality, users need to add an LLM provider of their choice from the list of available models on the Admin page.. e.g If you prefer to use OpenAI then you can get the API keys from OpenAI API key .
Once you decided which model provider to use, Go to Onyx GUI, from the admin panel page , click on LLM tab in left panel. Setup your model here.
Now you are good to go. Exit Admin and run your queries from the chat interface. You can see default model at the right bottom of the chat box which will be used to answer your queries. You can also upload your files and run queries against them.
You can also use public IPv4 DNS to access the Web UI. Copy the DNS address from the VM’s details page.
We recommend to reserve the Public IP address and make it static in order to access Onyx in browser over the same IP after VM restart.
Below are the steps for reserving public IP and making it static:
Note down the Availability Zone of Elastic IP cloud ide instance.
In the left pane of EC2 go to Network & Security and select Elastic IPs option.
On Elastic IPs page click on Allocate Elastic IP Address
Select the Network Border Group as per the availability zone of the instance. Select Amazon’s pool of IPv4 addresses radio button and click on allocate.
Once the Elastic IP is allocated, select the Elastic IP and under Actions dropdown select Associate Elastic IP address.
On this page select the instance radio button,enter Instance id, Private IP Adress of the VM and click Associate.
Now go to the instance details page and navigate to Networking tab. Here you can see Elastic IP is associated to the instance.
