{"_id":"573ed26ba233380e005db13e","category":{"_id":"573ecfe0804f901700a9dfc7","version":"5735936aafab441700723a53","project":"5735936aafab441700723a50","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-05-20T08:50:40.206Z","from_sync":false,"order":5,"slug":"customising-your-ensembl","title":"Next steps"},"parentDoc":null,"project":"5735936aafab441700723a50","user":"573592b84b0ab120000b7d44","version":{"_id":"5735936aafab441700723a53","__v":12,"project":"5735936aafab441700723a50","createdAt":"2016-05-13T08:42:18.615Z","releaseDate":"2016-05-13T08:42:18.615Z","categories":["5735936aafab441700723a54","5735a32931a73b1700887c94","5735b55beceb872200abbc6c","5735b56eb667601700d3bd6f","5735b9ba4b0ab120000b7dd4","5735b9c94b0ab120000b7dd5","5735cb131f16241700c8a0f7","5735e5c4e4824c3400aa1f21","5735e5d9e4824c3400aa1f23","5735e5f2ec67f6290013ac72","573ecfe0804f901700a9dfc7","573f276c7eeb8b190094ca7d"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":10,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-20T09:01:31.104Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"After running [Step 4.2: Reload Ensembl website](doc:step-42-reload-ensembl-website), your Ensembl should be running on the port you specified (default ``8080``).  Assuming you want to host your Ensembl as a publicly facing web site, there are now three stages to make sure your site is working and visible.\n\n### On the virtual machine\n\nTo be visible anywhere else, the site must be running and accessible on the virtual machine (VM) it is installed on.  The script in [Step 4.2](doc:step-42-reload-ensembl-website) includes a check for this but to be sure try running:\n\n```\ncurl http://localhost:8080/index.html | less\n```\n\nYour screen should now be filled with the text of the home page of your Ensembl instance (type ``q`` to quit).  To check the species you intended to import have been included, either scroll through the file of search by typing ``/species_name``.\n\n### On the VM host\n\nNow you'll need to know the IP of your VM (type ``ifconfig`` while logged into the VM to find this if you don't already have it noted down).\n\nThen on the VM host (assuming it is a server without a graphical interface), you should be able to see the text of your Ensembl instance home page as before, using the IP you just noted down in place of the example below.\n\n```\ncurl http://192.168.122.1:8080/index.html | less\n```\n\nIf you are hosting your VM on a laptop, then at this stage it should be enough to type ``http://192.168.122.1:8080/index.html`` (with your own IP and port number) into the address bar of a web browser.\n\nIf nothing happens, or you see an error instead of the text you are expecting then the most likely cause is a firewall on your VM host preventing the connection.  You will need modify your firewall to allow port ``8080`` then try again.\n\n### Everywhere else\n\nThis is beyond the scope of these instructions, but if you want the site to be visible to the outside world then you will likely need to register a domain, configure the DNS A-record to point your domain to the IP of your VM host, use the Apache/Lighttpd mod_proxy module to redirect requests to the VM and negotiate any institutional firewalls along the way.","excerpt":"","slug":"viewing-your-ensembl-instance","type":"basic","title":"Viewing your Ensembl instance"}

Viewing your Ensembl instance


After running [Step 4.2: Reload Ensembl website](doc:step-42-reload-ensembl-website), your Ensembl should be running on the port you specified (default ``8080``). Assuming you want to host your Ensembl as a publicly facing web site, there are now three stages to make sure your site is working and visible. ### On the virtual machine To be visible anywhere else, the site must be running and accessible on the virtual machine (VM) it is installed on. The script in [Step 4.2](doc:step-42-reload-ensembl-website) includes a check for this but to be sure try running: ``` curl http://localhost:8080/index.html | less ``` Your screen should now be filled with the text of the home page of your Ensembl instance (type ``q`` to quit). To check the species you intended to import have been included, either scroll through the file of search by typing ``/species_name``. ### On the VM host Now you'll need to know the IP of your VM (type ``ifconfig`` while logged into the VM to find this if you don't already have it noted down). Then on the VM host (assuming it is a server without a graphical interface), you should be able to see the text of your Ensembl instance home page as before, using the IP you just noted down in place of the example below. ``` curl http://192.168.122.1:8080/index.html | less ``` If you are hosting your VM on a laptop, then at this stage it should be enough to type ``http://192.168.122.1:8080/index.html`` (with your own IP and port number) into the address bar of a web browser. If nothing happens, or you see an error instead of the text you are expecting then the most likely cause is a firewall on your VM host preventing the connection. You will need modify your firewall to allow port ``8080`` then try again. ### Everywhere else This is beyond the scope of these instructions, but if you want the site to be visible to the outside world then you will likely need to register a domain, configure the DNS A-record to point your domain to the IP of your VM host, use the Apache/Lighttpd mod_proxy module to redirect requests to the VM and negotiate any institutional firewalls along the way.