---
updatedAt: 2025-09-18T23:17:49.000Z
agentTools:
projectIndex: https://docs.popsql.com/llms.txt
---
# Connecting to Timescale
1. Open the connections page in preferences, see [managing connections](https://docs.popsql.com/docs/connecting-to-your-database#managing-connections) for more information.
2. Click the `Add new Connection` button at the top of the connections page.\
3. Select `Timescale` from the list.
4. Give a `Connection name` for your own internal reference.
5. For `Hostname`, enter the hostname of your Timescale service.
6. For `Port`, use the default `5432`, or enter the port used by your service.
7. For `Database`, enter the name of the database of your service.
8. For `Username` and `Password`, enter the username and password for your service.
9. Toggle [connection type](https://docs.popsql.com/docs/cloud-direct-connections) for direct or cloud.
10. [Share the connection](https://docs.popsql.com/docs/shared-connections) with your team.
11. Configure `SSH` and `SSL` settings. These are optional.
12. Hit `Connect` and you're all set!
Happy querying! 🍭