This article needs additional citations for verification. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed.Find sources: "Gnutella" – news · newspapers · books · scholar · JSTOR (July 2013) (Learn how and when to remove this template message)
This article needs to be updated. Please help update this article to reflect recent events or newly available information. (May 2016)

Gnutella is a peer-to-peer network protocol. Founded in 2000, it was the first decentralized peer-to-peer network of its kind, leading to other, later networks adopting the model.[1]

In June 2005, Gnutella's population was 1.81 million computers[2] increasing to over three million nodes by January 2006.[3] In late 2007, it was the most popular file-sharing network on the Internet with an estimated market share of more than 40%.[4]


The first client (also called Gnutella) from which the network got its name[5][6] was developed by Justin Frankel and Tom Pepper of Nullsoft in early 2000, soon after the company's acquisition by AOL. On March 14, the program was made available for download on Nullsoft's servers. The event was prematurely announced on Slashdot, and thousands downloaded the program that day.[7][8] The source code was to be released later, under the GNU General Public License (GPL); however, the original developers never got the chance to accomplish this purpose.[9]

The next day, AOL stopped the availability of the program over legal concerns and restrained Nullsoft from doing any further work on the project. This did not stop Gnutella; after a few days, the protocol had been reverse engineered, and compatible free and open source clones began to appear.[10] This parallel development of different clients by different groups remains the modus operandi of Gnutella development today.

Among the first independent Gnutella pioneers were Gene Kan and Spencer Kimball, who launched the first portal aimed to assemble the open-source community to work on Gnutella[11][12] and also developed "GNUbile", one of the first open-source (GNU-GPL) programs to implement the Gnutella protocol.[13][14][15]

The Gnutella network is a fully distributed alternative to such semi-centralized systems as FastTrack (KaZaA) and the original Napster. The initial popularity of the network was spurred on by Napster's threatened legal demise in early 2001. This growing surge in popularity revealed the limits of the initial protocol's scalability. In early 2001, variations on the protocol (first implemented in proprietary and closed source clients) allowed an improvement in scalability. Instead of treating every user as client and server, some users were now treated as ultrapeers, routing search requests and responses for users connected to them.

This allowed the network to grow in popularity. In late 2001, the Gnutella client LimeWire Basic became free and open source. In February 2002, Morpheus, a commercial file sharing group, abandoned its FastTrack-based peer-to-peer software and released a new client based on the free and open source Gnutella client Gnucleus.

The word Gnutella today refers not to any one project or piece of software, but to the open protocol used by the various clients.

The name is a portmanteau of GNU and Nutella, the brand name of an Italian hazelnut flavored spread: supposedly, Frankel and Pepper ate a lot of Nutella working on the original project, and intended to license their finished program under the GNU General Public License. Gnutella is not associated with the GNU project[16] or GNU's own peer-to-peer network, GNUnet.

On October 26, 2010, the popular Gnutella client LimeWire was ordered shut down by Judge Kimba Wood of the United States District Court for the Southern District of New York when she signed a Consent Decree to which recording industry plaintiffs and LimeWire had agreed. This event was the likely cause of a notable drop[17] in the size of the network, because, while negotiating the injunction, LimeWire staff had inserted remote-disabling code into the software. As the injunction came into force, users who had installed affected versions (newer than 5.5.10) were cut off from the P2P network. Since LimeWire was free software, nothing had prevented the creation of forks that omitted the disabling code, as long as LimeWire trademarks were not used. The shutdown did not affect, for example, FrostWire, a fork of LimeWire created in 2004 that carries neither the remote-disabling code nor adware.

On November 9, 2010, LimeWire was resurrected by a secret team of developers and named LimeWire Pirate Edition.[18] It was based on LimeWire 5.6 BETA. This version had its server dependencies removed and all the PRO features enabled for free.


A diagram of Gnutella nodes and their connections.
The gnutella search and retrieval protocol

To envision how Gnutella originally worked, imagine a large circle of users (called nodes), each of whom has Gnutella client software. On initial startup, the client software must bootstrap and find at least one other node. Various methods have been used for this, including a pre-existing address list of possibly working nodes shipped with the software, using updated web caches of known nodes (called Gnutella Web Caches), UDP host caches and, rarely, even IRC. Once connected, the client requests a list of working addresses. The client tries to connect to the nodes it was shipped with, as well as nodes it receives from other clients until it reaches a certain quota. It connects to only that many nodes, locally caching the addresses which it has not yet tried and discarding the addresses which it tried and found to be invalid.[19]

When the user wants to do a search, the client sends the request to each actively connected node. In version 0.4 of the protocol, the number of actively connected nodes for a client was quite small (around 5). In that version of the protocol, each node forwards the request to all its actively connected nodes, who, in turn, forward the request. This continues until the packet has reached a predetermined number of hops from the sender (maximum 7).[20]

Since version 0.6 (2002[21]), Gnutella is a composite network made of leaf nodes and ultra nodes (also called ultrapeers). The leaf nodes are connected to a small number of ultrapeers (typically 3) while each ultrapeer is connected to more than 32 other ultrapeers. With this higher outdegree, the maximum number of hops a query can travel was lowered to 4.

Leaves and ultrapeers use the Query Routing Protocol to exchange a Query Routing Table (QRT), a table of 64 Ki-slots and up to 2 Mi-slots consisting of hashed keywords. A leaf node sends its QRT to each of the ultrapeers to which it is connected, and ultrapeers merge the QRT of all their leaves (downsized to 128 Ki-slots) plus their own QRT (if they share files) and exchange that with their own neighbors. Query routing is then done by hashing the words of the query and seeing whether all of them match in the QRT. Ultrapeers do that check before forwarding a query to a leaf node, and also before forwarding the query to a peer ultra node provided this is the last hop the query can travel.

If a search request turns up a result, the node that has the result contacts the searcher. In the classic Gnutella protocol, response messages were sent back along the route taken by the query, as the query itself did not contain identifying information for the node. This scheme was later revised, to deliver search results over UDP, directly to the node that initiated the search, usually an ultrapeer of the node. Thus, in the current protocol, the queries carry the IP address and port number of either node. This lowers the amount of traffic routed through the Gnutella network, making it significantly more scalable.[22]

If the user decides to download the file, they negotiate the file transfer. If the node which has the requested file is not firewalled, the querying node can connect to it directly. However, if the node is firewalled, stopping the source node from receiving incoming connections, the client wanting to download a file sends it a so-called push request to the server for the remote client to initiate the connection instead (to push the file). At first, these push requests were routed along the original chain it used to send the query. This was rather unreliable because routes would often break and routed packets are always subject to flow control. push proxies were introduced to address this problem. These are usually the ultrapeers of a leaf node and they are announced in search results. The client connects to one of these push proxies using an HTTP request and the proxy sends a push request to a leaf on behalf of the client. Normally, it is also possible to send a push request over UDP to the push proxy, which is more efficient than using TCP. Push proxies have two advantages: First, ultrapeer-leaf connections are more stable than routes. This makes push requests much more reliable. Second, it reduces the amount of traffic routed through the Gnutella network.[23]

Finally, when a user disconnects, the client software saves a list of known nodes. This contains the nodes to which the client was connected and the nodes learned from pong packets. The client uses that as its seed list, when it next starts, thus becoming independent of bootstrap services.[24]

In practice, this method of searching on the Gnutella network was often unreliable. Each node is a regular computer user; as such, they are constantly connecting and disconnecting, so the network is never completely stable. Also, the bandwidth cost of searching on Gnutella grew exponentially to the number of connected users,[25] often saturating connections and rendering slower nodes useless. Therefore, search requests would often be dropped, and most queries reached only a very small part of the network. This observation identified the Gnutella network as an unscalable distributed system, and inspired the development of distributed hash tables, which are much more scalable but support only exact-match, rather than keyword, search.[26]

To address the problems of bottlenecks, Gnutella developers implemented a tiered system of ultrapeers and leaves. Instead of all nodes being considered equal, nodes entering the network were kept at the 'edge' of the network, as a leaf. Leaves don't provide routing. Nodes which are capable of routing messages are promoted to ultrapeers. Ultrapeers accept leaf connections and route searches and network maintenance messages. This allows searches to propagate further through the network and allows for numerous alterations in topology. This greatly improved efficiency and scalability.[27]

Additionally, gnutella adopted a number of other techniques to reduce traffic overhead and make searches more efficient. Most notable are Query Routing Protocol (QRP) and Dynamic Querying (DQ). With QRP, a search reaches only those clients which are likely to have the files, so searches for rare files become far more efficient. With DQ, the search stops as soon as the program has acquired enough search results. This vastly reduces the amount of traffic caused by popular searches.[28]

One of the benefits of having Gnutella so decentralized is to make it very difficult to shut the network down and to make it a network in which the users are the only ones who can decide which content will be available. Unlike Napster, where the entire network relied on the central server, Gnutella cannot be shut down by shutting down any one node. A decentralized network prevents bad actors from taking control of the contents of the network and/or manipulating data by controlling the central server.[29]

Protocol features and extensions

Gnutella once operated on a purely query flooding-based protocol. The outdated Gnutella version 0.4 network protocol employs five different packet types, namely:[30]

These packets facilitate searches. File transfers are instead handled by HTTP.[31]

The development of the Gnutella protocol is currently led by the Gnutella Developers Forum (The GDF). Many protocol extensions have been and are being developed by the software vendors and by the free Gnutella developers of the GDF. These extensions include intelligent query routing, SHA-1 checksums, query hit transmission via UDP, querying via UDP, dynamic queries via TCP, file transfers via UDP, XML metadata, source exchange (also termed the download mesh) and parallel downloading in slices (swarming).[31]

There are efforts to finalize these protocol extensions in the Gnutella 0.6 specification, at the Gnutella protocol development website. The Gnutella 0.4 standard is outdated but it remains the latest protocol specification because all extensions, so far, exist as proposals. In fact, it is hard or impossible to connect today with 0.4 handshakes. According to developers in the GDF, version 0.6 is what new developers should pursue using the work-in-progress specifications.[32]

The Gnutella protocol remains under development. Despite attempts to make a clean break with the complexity inherited from the old Gnutella 0.4 and to design a clean new message architecture, it remains one of the most successful file-sharing protocols to date.[33]


The following tables compare general and technical information for a number of applications supporting the Gnutella network. The tables do not attempt to give a complete list of Gnutella clients. The tables are limited to clients that can participate in the current Gnutella network.

General specifications

Name Platform License Project active?
(otherwise discontinued)
Latest release Heritage
Acquisition macOS Proprietary No 2.2 (v223) (November 19, 2010; 13 years ago (2010-11-19)) [±] LimeWire
BearFlix Windows Proprietary No BearShare
BearShare Windows Proprietary No (January 29, 2013; 11 years ago (2013-01-29)) [±] Original work
Cabos Java GPL No 0.8.2 (February 9, 2010; 14 years ago (2010-02-09)) [±] LimeWire
CitrixWire Windows Proprietary No 2014[34] Addax
CocoGnut RISC OS Proprietary No 1.21 (2005-06-21) Original work
FilesWire (P2P) Java Proprietary No Beta 1.1 (2007) Original work
giFT (Gnutella plug-in) Cross-platform GPL No 0.0.11 (2006-08-06) Original work
Gnucleus-GnucDNA Windows GPL, LGPL No (June 17, 2005; 18 years ago (2005-06-17)) [±] Original work
gtk-gnutella Cross-platform GPL Yes 1.2.2 (February 25, 2022; 2 years ago (2022-02-25)) [±] Original work
KCeasy Windows GPL No 0.19-rc1 (February 3, 2008; 16 years ago (2008-02-03)) [±] giFT
Kiwi Alpha Windows GPL No (June 17, 2005; 18 years ago (2005-06-17)) [±] GnucDNA
LimeWire Java GPL No 5.5.16 (September 30, 2010; 13 years ago (2010-09-30)) [±] Original work
Morpheus Windows Proprietary No 5.55.1 (November 15, 2007; 16 years ago (2007-11-15)) [±] GnucDNA
Phex Java GPL No (February 1, 2009; 15 years ago (2009-02-01)) [±] Original work
Poisoned macOS GPL No 0.5191 (August 8, 2006; 17 years ago (2006-08-08)) [±] giFT
Shareaza Windows GPL Yes (September 18, 2017; 6 years ago (2017-09-18)[35]) [±] Original work
Symella Symbian GPL No Original work
WireShare (aka LimeWire Pirate Edition) Java GPL Yes 6.0.2 (2022-10-04) LimeWire
Zultrax Windows Proprietary No 4.33 (April 2009) Original work

  Discontinued project

Gnutella features

Client Hash search Chat[i] Buddy list Handles large files (> 4 GB) Unicode-compatible query routing UPnP port mapping[ii] NAT traversal NAT port mapping RUD[iii] TCP push proxy UDP push proxy Ultrapeer GWebCache[iv] UDP host cache THEX TLS Other
BearShare Yes Yes Yes No No Yes Yes Yes Yes Yes No Yes Yes No Yes No -
giFT (core & plug-ins) Yes No No No No No No Yes [a] No No [b] Yes No No No -
GnucDNA [c] Yes No No No No No No Yes No No [b] Yes No No No -
gtk-gnutella Yes [d] No No Yes Yes Yes Yes Yes Yes [e] Yes Yes Yes No (Dropped) Yes Yes Yes IPv6, DHT, GUESS, G2
LimeWire[f] Yes [d] Yes GMail or XMPP Yes Yes Yes Yes [g] Yes [h] Yes Yes Yes Yes Yes Yes Yes Yes DHT
WireShare[f] Yes [d] Yes GMail or XMPP Yes Yes Yes Yes [g] Yes [h] Yes Yes Yes Yes Yes Yes Yes Yes DHT
Phex Yes Yes No Yes Yes No Yes[i] No No Yes No Yes Yes Yes Yes Yes I2P
Shareaza Yes Yes No Yes No Yes Yes Yes No Yes Yes Yes Yes Yes[j] Yes No G2, BT, eD2k, IRC


  1. ^ Refers to direct client-to-client chat; not IRC chat, which is often also available in the same application through an embedded HTTP browser window.
  2. ^ Automatically configures port forwarding in routers or combination modem/gateways which support UPnP control.
  3. ^ The Reliable UDP protocol provides NAT-to-NAT transfers, sometimes called Firewall-to-Firewall or "hole-punching", in cases where port-forwarding is not or cannot be done by the user.
  4. ^ As GWCs had a history of problems with traffic overload and long-term reliability, UDP host caches became the preferred bootstrap method; though some GWCs remain available for the sake of older software.
  1. ^ Client mode only, as a dependent leaf on ultrapeers.
  2. ^ a b Not high outdegree, so is unusable in its current form.
  3. ^ Version
  4. ^ a b c Via the Kademlia-based Mojito DHT network supported only by LimeWire and gtk-gnutella (starting with version r15750); this is completely different from SHA-1 searches supported by most gnutella clients.
  5. ^ gtk-gnutella version 0.98.4 and later.
  6. ^ a b As the LimeWire client is no longer available clients that share most of LimeWire's code base, like FrostWire, can provide an alternative.
  7. ^ a b Port triggering or firewall to firewall (FW2FW).
  8. ^ a b Automatic with UPnP, or manual configuration in LimeWire firewall options
  9. ^ Via SOCKS proxy which can tunnel over SSH.
  10. ^ Since version


Main article: Gnutella2

The Gnutella2 protocol (often referred to as G2), despite its name, is not a successor protocol of Gnutella nor related to the original Gnutella project,[36] but rather is a completely different protocol that forked from the original project and piggybacked on the Gnutella name. A sore point with many Gnutella developers is that the Gnutella2 name conveys an upgrade or superiority, which led to a flame war. Other criticism included the use of the Gnutella network to bootstrap G2 peers and poor documentation of the G2 protocol. Additionally, the more frequent search retries of the Shareaza client, one of the initial G2 clients, could unnecessarily burden the Gnutella network.[37]

Both protocols have undergone significant changes since the fork in 2002. G2 has advantages and disadvantages compared to Gnutella. An advantage often cited is that Gnutella2's hybrid search is more efficient than the original Gnutella's query flooding. However, Gnutella replaced query flooding with more efficient search methods, starting with Query Routing in 2002. This was proposed in 2001 by Limewire developers.[38][39][40] An advantage of Gnutella is its large user base, which numbers in the millions,[3]. The G2 network is approximately an order of magnitude smaller.[41] It is difficult to compare the protocols in their current form. The choice of client, on either network, probably affects the end user just as much.

See also


  1. ^ Kushner, David (January 13, 2004). "The World's Most Dangerous Geek". Rolling Stone. Archived from the original on June 30, 2012. Retrieved May 10, 2011.
  2. ^ Slyck News - eDonkey2000 Nearly Double the Size of FastTrack Archived 2018-01-29 at the Wayback Machine, Thomas Mennecke for, June 2, 2005.
  3. ^ a b On the Long-term Evolution of the Two-Tier Gnutella Overlay Archived 2017-08-10 at the Wayback Machine. Rasti, Stutzbach, Rejaie, 2006. See Figure 2a.
  4. ^ Ars Technica Study: BitTorrent sees big growth, LimeWire still #1 P2P app Archived 2008-12-16 at the Wayback Machine Eric Bangeman, April 21, 2008.
  5. ^ "AOL's Nullsoft creates software for swapping MP3s". CNET. Archived from the original on 2015-04-15. Retrieved 2017-04-13.
  6. ^ "Gnutella". AfterDawn. Archived from the original on 2017-04-14. Retrieved 2017-04-13.
  7. ^ "Open Source Napster: Gnutella - Slashdot". 14 March 2000. Archived from the original on 2019-03-24. Retrieved 2019-03-24.
  8. ^ "CNN - Breaking News, Latest News and Videos". CNN. Archived from the original on 2000-06-20. Retrieved 2019-03-24.
  9. ^ "Regarding Gnutella - GNU Project - Free Software Foundation". Archived from the original on 2015-03-16. Retrieved 2015-03-17.
  10. ^ Schell, Bernadette Hlubik; Schell, Bernadette; Martin, Clemens (2006-09-05). Webster's New World Hacker Dictionary. John Wiley & Sons. ISBN 978-0-470-04752-1. Archived from the original on 2023-01-17. Retrieved 2020-10-02.
  11. ^ "Programmers help "Napster" clones take off". CNET. Archived from the original on 2015-04-16. Retrieved 2017-04-13.
  12. ^ "Gnutella pioneer Gene Kan dies". CNET. Archived from the original on 2015-04-16. Retrieved 2017-04-13.
  13. ^ "gnubile file listing". Archived from the original on 2016-04-22. Retrieved 2017-04-13.
  14. ^ "The source code for Gnubile". Archived from the original on 2016-03-04. Retrieved 2017-04-13.
  15. ^[permanent dead link]
  16. ^ "Regarding Gnutella (". Archived from the original on 2015-03-16. Retrieved 2015-03-17.
  17. ^ Chloe Albanesius (18 July 2011). "Indie Labels Sue LimeWire Over Failed Copyright Deal". PC Magazine. Ziff-Davis. Archived from the original on 2 February 2016. Retrieved 19 March 2012. In the wake of the LimeWire shutdown, the percentage of U.S. Internet users who access P2P file-sharing services dropped about 7 percent from [its] all-time high in 2007...
  18. ^ Chloe Albanesius (9 November 2010). "Report: LimeWire 'Resurrected' by Secret Dev Team". PC Magazine. Ziff-Davis. Archived from the original on 12 July 2017. Retrieved 19 March 2012.
  19. ^ "How Auto Discovery Works - Amazon ElastiCache". Archived from the original on 2023-03-30. Retrieved 2023-06-08.
  20. ^ Moon, Jongbae; Cho, Yongyun (2011). "A point-based inventive system to prevent free-riding on p2p network environments". Computational Science and Its Applications - ICCSA 2011 Proceedings. Springer. p. 464. ISBN 978-3-642-21897-2. Archived from the original on 2023-01-17. Retrieved 2022-03-10.
  21. ^ "Gnutella Protocol Development". Archived from the original on 2017-05-12. Retrieved 2017-04-13.
  22. ^ Ripeanu, Matei; Nakai, Yugo. "Topology of Gnutella Network: Discovery and Analysis". Archived from the original on 2023-11-03. Retrieved 2023-06-08. ((cite journal)): Cite journal requires |journal= (help)
  23. ^ "Gnutella clients that still work". apreasnisuf1984's Ownd (in Japanese). 2022-05-09. Archived from the original on 2023-11-03. Retrieved 2023-06-08.
  24. ^ Franzoni, Federico; Daza, Vanesa (2022). "SoK: Network-Level Attacks on the Bitcoin P2P Network". IEEE Access. 10: 94924–94962. Bibcode:2022IEEEA..1094924F. doi:10.1109/ACCESS.2022.3204387. hdl:10230/55353. ISSN 2169-3536. S2CID 252106900. Archived from the original on 2022-09-26. Retrieved 2023-07-11.
  25. ^ Why Gnutella Can't Scale. No, Really. Archived 2017-08-06 at the Wayback Machine February 2001.
  26. ^ Hasselbring, Wilhelm (2004-01-01). "A hierarchical super peer network for distributed software development". Archived from the original on 2023-11-03. Retrieved 2023-06-08. ((cite journal)): Cite journal requires |journal= (help)
  27. ^ "Network Topology - an overview | ScienceDirect Topics". Archived from the original on 2023-10-18. Retrieved 2023-06-08.
  28. ^ "DQ in Arabic - English-Arabic Dictionary | Glosbe". Archived from the original on 2024-04-09. Retrieved 2023-06-08.
  29. ^ Berkes, Jem (April 9, 2003). "Decentralized Peer-to-Peer Network Architecture: Gnutella and Freenet" (PDF). University of Manitoba. Archived from the original (PDF) on August 8, 2017. Retrieved October 26, 2019.
  30. ^ Dye, Mark. McDonald, Rick. Rufi, Antoon W., 'Network Fundamentals', Cisco Networking Academy, Cisco Press, Ch 3. p91
  31. ^ a b Dye, Mark. McDonald, Rick. Rufi, Antoon W., 'Network Fundamentals', Cisco Networking Academy, Cisco Press, Ch 3. p90
  32. ^ "Gnutella Protocol Development". Archived from the original on 2022-12-06. Retrieved 2022-07-21.
  33. ^ Tyson, Gareth. "A Middleware Approach to Building Content-Centric Applications". Archived from the original on 2023-11-03. Retrieved 2023-06-08. ((cite journal)): Cite journal requires |journal= (help)
  34. ^ "CitrixWire". BrotherSoft. Archived from the original on 2017-04-14. Retrieved 2017-04-13.
  35. ^ "Shareaza download page on sourceforge Web site". SourceForge. Retrieved 2019-07-06.
  36. ^ Gnutella vs. Gnutella2, Part 2 Archived 2012-07-28 at the Wayback Machine Thomas Mennecke for, February 25, 2003.
  37. ^ Gnutella vs. Gnutella2, Part 1 Archived 2016-03-05 at the Wayback Machine Thomas Mennecke for, February 25, 2003
  38. ^ A comparison of Peer-to-Peer search methods Archived 2007-09-26 at the Wayback Machine Dimitrios Tsoumakos, 2003
  39. ^ Query Routing for the Gnutella Network proposal Archived 2015-09-24 at the Wayback Machine Christopher Rohrs, 2001-12-18
  40. ^ Query Routing for the Gnutella Network 1.0 Archived 2015-09-24 at the Wayback Machine Christopher Rohrs, 2002-05-16
  41. ^ G2 Network Statistics Archived 2010-05-01 at the Wayback Machine Population ~200,000 January 2010.