0Pricing
Linux Networking & TCP/IP for Developers · Lesson

TCP Client-Server Sockets

Implement reliable, connection-oriented communication by building basic TCP client and server applications in Python.

TCP Client-Server Sockets is a free Linux Networking & TCP/IP for Developers lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Linux Networking & TCP/IP for Developers learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

TCP Sockets: Connection First

Welcome to building network applications with Python! This lesson focuses on TCP (Transmission Control Protocol) sockets, which are the backbone of reliable internet communication.

Unlike UDP, TCP is a connection-oriented protocol. This means a direct, stable link is established between two applications before any data is sent.

Why TCP is Reliable

TCP ensures your data arrives correctly and in order. It handles:

  • Guaranteed Delivery: Data segments are retransmitted if lost.
  • Ordered Data: Data arrives in the order it was sent.
  • Error Checking: Data integrity is verified.
  • Flow Control: Prevents a fast sender from overwhelming a slow receiver.

This makes TCP ideal for web browsing, email, and file transfers.

TCP Server: The Listener

A TCP server's role is to listen for incoming connections from clients. Here's the typical workflow for a server:

  1. Create a socket.
  2. Bind the socket to an IP address and port.
  3. Listen for client connections.
  4. Accept an incoming connection.
  5. Communicate (send/receive data).
  6. Close the sockets.

Creating a Python TCP Socket

In Python, we use the built-in socket module. To create a TCP socket, we specify socket.AF_INET for IPv4 addressing and socket.SOCK_STREAM for TCP.

Try running this basic example:

import socket

def main():
    # Create a TCP/IP socket
    # AF_INET for IPv4, SOCK_STREAM for TCP
    tcp_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    print("TCP socket created successfully!")
    tcp_socket.close()
    print("Socket closed.")

if __name__ == "__main__":
    main()

Server: Bind to Address & Port

After creating the socket, the server needs to bind it to a specific IP address and port number. This tells the operating system where the server will listen for connections.

.bind((HOST, PORT)) associates the socket. .listen(backlog) prepares it to accept connections, with backlog being the max queued connections.

import socket

def main():
    HOST = '127.0.0.1'  # Localhost
    PORT = 65432        # Port to listen on (non-privileged)

    server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    try:
        server_socket.bind((HOST, PORT))
        server_socket.listen(1) # Allow 1 pending connection
        print(f"Server listening on {HOST}:{PORT}")
    except Exception as e:
        print(f"Error binding or listening: {e}")
    finally:
        server_socket.close()
        print("Server socket closed.")

if __name__ == "__main__":
    main()

Server: Accepting a Client

The .accept() method is crucial for a server. It blocks execution until a client tries to connect. When a connection is made, it returns two values:

  • A new socket object (conn) for communicating with that specific client.
  • The client's address (addr), a (host, port) tuple.
import socket

def main():
    HOST = '127.0.0.1'
    PORT = 65432

    server_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    server_socket.bind((HOST, PORT))
    server_socket.listen(1)
    print(f"Server waiting for connection on {HOST}:{PORT}...")

    # This will block until a client connects
    conn, addr = server_socket.accept()
    with conn: # Use 'with' for auto-closing the client socket
        print(f"Connected by client from {addr}")
        # In a real app, send/recv would happen here
        conn.sendall(b"Hello from server!") # Send some bytes
        print("Sent greeting to client.")
    server_socket.close()
    print("Server socket closed.")

if __name__ == "__main__":
    main()

TCP Client: Initiating Connection

A TCP client's role is to initiate a connection to a server. Here's its typical workflow:

  1. Create a socket.
  2. Connect to the server's IP address and port.
  3. Communicate (send/receive data).
  4. Close the socket.

Client: Connecting to Server

The client uses the .connect((HOST, PORT)) method to establish a connection with the server. If successful, a virtual circuit is created. If the server isn't listening, you'll get a ConnectionRefusedError.

Run this. If no server is running, it will show an error:

import socket

def main():
    HOST = '127.0.0.1'  # Server's IP address
    PORT = 65432        # Server's port

    client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    try:
        print(f"Attempting to connect to server at {HOST}:{PORT}...")
        client_socket.connect((HOST, PORT))
        print("Successfully connected to the server!")
    except ConnectionRefusedError:
        print("Connection refused. Is the server running?")
    except Exception as e:
        print(f"Client connection error: {e}")
    finally:
        client_socket.close()
        print("Client socket closed.")

if __name__ == "__main__":
    main()

Sending & Receiving Data

Once connected, both client and server can send and receive data. Remember that network data is transmitted as bytes, so you'll often need to .encode() strings before sending and .decode() received bytes back into strings.

  • .sendall(data): Sends all data reliably.
  • .recv(buffer_size): Receives up to buffer_size bytes.
import socket

def main():
    HOST = '127.0.0.1'
    PORT = 65432

    client_socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    try:
        client_socket.connect((HOST, PORT))
        message = "Hello from the client!"
        client_socket.sendall(message.encode('utf-8'))
        print(f"Client sent: '{message}'")

        data = client_socket.recv(1024) # Receive up to 1024 bytes
        if data:
            print(f"Client received: '{data.decode('utf-8')}'")
        else:
            print("Client received no data (server might have closed).")
    except ConnectionRefusedError:
        print("Connection refused. Please run the server example first!")
    except Exception as e:
        print(f"Client communication error: {e}")
    finally:
        client_socket.close()
        print("Client socket closed.")

if __name__ == "__main__":
    main()

TCP Communication Flow

Consider the typical steps for a Python TCP server to establish a connection and an echo client to communicate.

Recap: TCP Client-Server Sockets

Great job! You've learned the fundamentals of TCP client-server communication in Python:

  • TCP provides reliable, connection-oriented communication.
  • Servers bind to an address, listen for connections, and accept clients.
  • Clients connect to a server's address.
  • Both use .sendall() to send and .recv() to receive bytes.

These concepts are crucial for building robust networked applications!

Frequently asked questions

Is the “TCP Client-Server Sockets” lesson free?

Yes — the full text of “TCP Client-Server Sockets” is free to read here on the web, and the Linux Networking & TCP/IP for Developers course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Linux Networking & TCP/IP for Developers course, upgrade to CoddyKit PRO.

What will I learn in “TCP Client-Server Sockets”?

Implement reliable, connection-oriented communication by building basic TCP client and server applications in Python. You practise Linux Networking & TCP/IP for Developers with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Linux Networking & TCP/IP for Developers?

No prior experience is required. Linux Networking & TCP/IP for Developers on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “TCP Client-Server Sockets” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Linux Networking & TCP/IP for Developers lesson?

Yes. Every Linux Networking & TCP/IP for Developers lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Introduction to Socket API
  2. TCP Client-Server Sockets
  3. UDP Client-Server Sockets
  4. Non-Blocking Sockets and select()
← Back to Linux Networking & TCP/IP for Developers