# IRC URL Scheme

> Historical reference: iRC URL Scheme.

This knowledge base article documents the [URL scheme](<https://en.wikipedia.org/wiki/URI_scheme>) that is recognized by Textual for creating new connections.

## Format

```text
<scheme>://<address>:<port>/[#channel[,#channel]]
```

### Required Components

**&lt;scheme&gt;** can be “irc” or “ircs” — [SSL/TLS](<https://en.wikipedia.org/wiki/Transport_Layer_Security>) is enabled if **&lt;scheme&gt;** is “ircs”

**&lt;address&gt;** can be a fully qualified domain name, an IPv4 address, or an IPv6 address.

### Optional Components

**&lt;port&gt;** is any whole number between 1 and 65,535. 6667 is used as the default if **&lt;port&gt;** is not specified.

**\[#channel\]** is a list of up to five (5) channels, each separated by a comma, that are added to the new connection.

## Privacy Considerations

A connection that is created by clicking a URL does not automatically connect when added. This is done to protect the identity of the user. If the user has their browser configured to a connect through a proxy, but not Textual, then having the user click on a link could lead to their IP address being leaked before they have a chance to stop it.

## Examples

```text
irc://irc.example.com
irc://irc.example.com:6667
irc://irc.example.com/#channel                    - Connect to #channel

irc://127.0.0.1/
irc://127.0.0.1:6667
irc;//127.0.0.1/#channel

irc://[fda4:22f1:8d20::]/
irc://[fda4:22f1:8d20::]:6667
irc://[fda4:22f1:8d20::]/#channel

ircs://irc.example.com:6697/#channel              - Connect to #channel using SSL
ircs://irc.example.com:6697/#channel1,#channel2   - Connect to #channel1 and #channel2 using SSL
```
