---
name: "Net.connect"
section: "3kaya"
platform: "linux"
package: "kaya"
version: "0.4.4-6.2"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net.connect"
---

# Net.connect(3kaya)

Connect to a server

## NAME

Net::connect - Connect to a server

## SYNOPSIS

**NetHandle connect(** *Protocol proto, String server, Int port, Bool usetls=false, \[String\] certfiles=\[\]* **)**

## ARGUMENTS

**proto** The network protocol to use

**server** The hostname or IP address of the server to connect to (e.g. **service.example.com**  , **localhost**  or **192.168.20.25**  )

**port** The network port to connect to

**usetls** If this is true, and the TLS library is available, then the connection will be encrypted. This parameter may be omitted and defaults to false.

**certs** An optional list of certificate files for TLS encrypted connections. Each file should contain one or more PEM-encoded certificates for a trusted certification authority. If this list is empty (the default), no certificate verification will be performed on encrypted connections, which is insecure.

## DESCRIPTION

Connect to a server (optionally using TLS). Returns a connection handle.

## AUTHORS

Kaya standard library by Edwin Brady, Chris Morris and others (kaya@kayalang.org). For further information see http://kayalang.org/

## LICENSE

The Kaya standard library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (version 2.1 or any later version) as published by the Free Software Foundation.

## RELATED

**Net.NetHandle (3kaya)**

**Net.Protocol (3kaya)**

**Net.closeConnection (3kaya)**

**Net.recv (3kaya)**

**Net.shutdown (3kaya)**

**Net.send (3kaya)**
